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BU E 


我 有 将 平时 工作 所 悟 写成 博客 以 记录 的 习惯 ， 随 着 逐渐 的 
只 累 ， 终 于 可 以 形成 目前 这 样 一 本 实战 性 的 手册 。 我 平时 在 阅 
读 大 量 的 Spring 相关 书籍 的 时 候 发 现 : 很 多 书籍 对 知识 的 讲解 
一 味 求 全 求 深 ， 导 致 该 者 很 难 快速 竺 握 茶 一 项 技术 ， 且 因为 求 
全 求 深 而 忽略 了 最 佳 实践 ， 让 读者 云 里 筋 里 ， 甚 至 半途 而 废 。 

所 以 本 书 的 每 个 章节 的 基本 架构 都 是 :点睛 + 实战 。 

扩 睛 : 用 最 简练 的 语言 去 描述 当前 的 技术 ; 

实战 .对 当前 技术 进行 实战 意义 的 代码 演示 。 

本 书 代码 的 为 一 个 特点 是 : 技术 相关 ， 业 务 不 相关 。 在 本 
书 的 实战 例子 中 不 会 假设 一 个 业务 需求 ， 然 后 让 读者 既 要 理解 
技术 ， 又 要 理解 假设 的 业务 ， 本 书 的 目标 是 让 读者 “学 习 时 只 
关注 技术 ， 开 发 时 只 关注 业务 ”。 

本 书 涉及 的 技术 比较 三 ， 尤 其 是 第 三 部 分 :实战 Spring 
Boot， 这 让 我 很 难 在 一 本 书 中 对 每 一 项 技术 细节 都 详细 说 明 ; 
我 希望 本 书 能 为 读者 在 相关 技术 应 用 上 抛砖引玉 ， 读 者 在 遇 到 
特定 技术 的 问题 时 可 以 去 学 习 特 定 技术 的 相关 书籍 。 


Spring 在 Java EE 开发 中 是 实际 意义 上 的 标准 ， 但 我 们 在 开 
发 Spring 的 时 候 可 能 会 遇 到 以 下 让 人 头疼 的 问题 : 


(1) 大 量 配置 文件 的 定义 ; 






































(20 与 第 三 方 软件 整合 的 技术 问题 。 


Spring 每 个 新 版 本 的 推出 都 以 减少 配置 作为 自己 的 主要 目 
bs. Bi Un: 


(1) fiHi(gComponent. (Service. @Repository, 
(Q Controller: f#7E 25 _E Fa H Bean; 


(2) 推出 @Configuration、@Bean 的 Java 配 置 来 蔡 代 xml 配 
置 。 











在 脚本 语言 和 敏捷 开发 大 行 其 道 的 时 代 ，Java EE 的 开发 显 
得 尤为 笨重 ， 让 人 误解 Java EE 开发 就 该 如 此 。Spring 在 提升 
Java EE 开发 效率 的 脚步 上 从 未 停止 过 ， 而 Spring Boot 的 推出 是 
HUS Bis FURIE UE AY. Spring Boot 上 共有 以 下 特征 : 


CD 遵循 “习惯 优 于 配置 "原则 ， 使 用 Spring Boot 只 需 很 少 
的 配置 ， 大 部 分 时 候 可 以 使 用 默认 配置 ; 


(20 项 目 快速 搭建 ， 可 无 配置 整合 第 三 方 框 染 ; 


(3) 可 完全 不 使 用 xml 配 置 ， 只 使 用 自动 配置 和 Java 
Config; 








(4) 内 髓 Servlet( 如 Tomcat) 容器， 应 用 可 用 jar 包 运行 
(java-jar) ; 


(5) 运行 中 应 用 状态 的 监控 。 


虽然 Spring ”Boot 给 我 们 带 来 了 类 似 于 脚本 语言 开发 的 效 
率 ， 但 Spring Boot 里 没有 使 用 任何 让 你 意外 的 技术 ， 完 全 是 一 
个 单纯 的 基于 Spring 的 应 用 。 如 Spring Boot 的 自动 配置 是 通过 
Spring ”4.x 的 @Conditional 注 解 来 实现 的 ， 所 以 在 学 习 Spring 
Boot 之 前 ， 我 们 需要 快速 学 习 Spring 与 Spring MVC 的 基础 知 





识 。 
第 一 部 分 : 点 睛 Spring 4.x 


快速 学 习 Spring 4.x 的 各 个 知识 点 ， 包 括 基础 配置 、 和 常用 配 
置 以 及 高 级 配置 ， 以 便 熟 悉 冲 用 配置 ， 并 体会 使 用 Java 语 法 配 
LEUTE CIE FEE e 


第 二 部 分 : 点 睛 Spring MVC 4.x 


快速 学 习 Spring MVC 4.1 的 各 个 知识 点 ，MVC 的 开发 是 我 
们 日 常 开 发 工作 中 最 常 打交道 的 ， 所 以 学 习 Spring MVC 对 
Spring Boot 的 使 用 极 有 帮助 。 


第 三 部 分 :实战 Spring Boot 

这 部 分 是 整 本 书 的 核心 部 分 ， 每 个 章节 都 会 通过 讲解 和 实 
战 的 例子 来 演示 Spring Boot 在 实际 项 目 中 过 到 的 方方面面 的 情 
况 ， 真 正 达 到 让 Spring Boot 成 为 JavaEE 开 发 的 实际 解决 方案 。 


Spring Boot 发 布 于 2014 年 4 月 ， 根 据 知 名 博 主 Baeldung 的 调 
查 ， 截 至 2014 年 年 底 ， 使 用 Spring Boot 作 为 Spring 开 发 方案 的 
己 有 34.1%， 这 是 多 么 惊人 的 速度 。 


希望 读者 在 阅读 完 本 书后 ， 能 够 快速 蔡 代 现 有 的 开发 方 
式 ， 使 用 Spring 。” Boot 进行 重 构 ， 和 大 量 配置 与 整合 开发 说 再 


Md, ! 

本 书 是 我 的 第 一 本 技术 书籍 ， 主 要 目的 是 让 读者 快速 上 手 
Spring Boot 这 项 颠 履 性 的 Java EE 开发 技术 ， 由 于 作者 水 平 有 
限 ， 书 中 丝 漏 之 处 在 所 难免 ， 敬 请 读者 批评 指正 。 









































第 一 部 分 AHE Spring 4.x 


第 1 章 ”Spring 基 础 


做 Java 开 发 的 程序 员 都 知道 Spring 的 大 名 ， 市 面 上 关于 
Spring 的 书籍 也 是 汗 牛 充 栋 。 本 书 介绍 的 Spring 4.x 不 是 对 
Spring 知识 点 的 全 面 讲 解 ， 而 是 将 工作 中 各 用 的 Spring 相关 的 
知识 点 罗列 出 来 ， 以 点 睛 的 形式 〈 快 速 讲解 + 示例 ) 让 读者 快 
速 掌握 Spring 在 开发 中 的 常用 知识 。 


1.1 Spring 概述 


1.1.1 Spring 的 简 史 








Spring 的 历史 网 上 有 很 多 介绍 ， 下 面 讲 下 我 杀 历 的 Spring 发 


的 过 程 。 
一 阶段 ， xml 配置 


在 Spring 1.x 时 代 ， 使 用 Spring 开发 满眼 都 是 xzml 配 置 的 
Bean， 随 着 项 目的 扩大 ， 我 们 需要 把 xm] 配 置 文件 分 放 到 不 同 
那 时 候 需 要 频繁 地 在 开发 的 类 和 配置 文件 之 间 
切换 。 


第 二 阶段 : 注解 配置 


在 Spring 2.x 时 代 ， 随 着 JDK 1.5 市 来 的 注解 文 持 ，Spring 提 
供 了 声明 Bean 的 注解 (如 @Component、@Service) ， 大 大 减 
少 了 配置 量 。 这 时 Spring 圈子 里 存在 着 一 种 争论 : 注解 配置 和 
xml 配 置 究竟 哪个 更 好 ? 我们 最 终 的 选择 是 应 用 的 基本 配置 
(如 数据 库 配 置 ) 用 xml， 业 务 配 置 用 注解 。 


三 阶段 Java 配置 


从 Spring 3.x 到 现在 ，Spring 提 供 了 Java 配 置 的 能 力 ， 使 用 
Java 配 置 可 以 让 你 更 理解 你 配置 的 Bean。 我 们 目前 刚好 处 于 这 
个 时 代 ，Spring 4.x 和 Spring Boot 都 推荐 使 用 Java 配 置 ， 所 以 我 
们 在 本 书 通 篇 将 使 用 Java 配 置 。 

















1.1.2 Spring 概述 


Spring 框架 是 一 个 轻 量 级 的 企业 级 开发 的 一 站 式 解决 方 
案 。 所 谓 解 决 方案 就 是 可 以 基于 Spring 解决 Java EE 开发 的 所 有 
问题 。Spring 框 架 主要 提供 了 IoC 容 器 、AOP、 数 据 访问 、Web 
开发 、 消 息 、 测 试 等 相关 技术 的 支持 。 


Spring 使 用 简单 的 POJO (Plain Old Java Object， 即 无 任何 
限制 的 普通 Java 对 象 ) 来 进行 企业 级 开发 。 每 一 个 被 Spring 管 
理 的 Java 对 象 都 称 之 为 Bean; 而 Spring 提供 了 一 个 IoC 容 吉 用 来 
初始 化 对 象 ， 解 诀 对 象 间 的 依赖 管理 和 对 象 的 使 用 。 


1.Spring 的 模块 


Spring 是 模块 化 的 ， 这 意味 着 你 可 以 只 使 用 你 需要 的 Spring 
的 模块 。 如 图 1-1 所 示 。 





© Spring Framework Runtime 


Data Access/Integration Web 







JDBC WebSocket Serviet 


Wi 


eb 


Portlet 








————— ey 
图 1-1 Spring 的 模块 
图 1-1 中 的 每 一 个 最 小 单元 ，Spring 都 至 少 有 一 个 对 应 的 jar 


1, 
(1) 核心 容器 (Core Container) 


Spring-Core: 核心 工具 类 ，Spring 其 他 模块 大 量 使 用 
Spring-Core; 





Spring-Beans: Spring 定义 Bean 的 文 持 ; 


Spring-Context: 运行 时 Spring 容器 ; 








Spring-Context-Support: Spring 容器 对 第 三 方 包 的 集成 支 
fF; 


Spring-Expression: 使 用 表达 式 语言 在 运行 时 查询 和 操作 
对 象 。 


(2) AOP 
Spring-AOP: 基于 代理 的 AOP 文 持 ; 
Spring-Aspects: Jt -AspectJH') AOP x 4$. 








(3) 消息 (Messaging) 
Spring-Messaging: 对 消息 架构 和 协议 的 文 持 。 
(4) Web 


Spring-Web: 提供 基础 的 web 集成 的 功能 ， 在 Web 项 目 中 
提供 Spring 的 容器 ; 


Spring-Webmvc: 提供 基于 Servlet 的 Spring MVC; 





Spring-WebSocket: 提供 WebSocket 功 能 ; 


Spring-Webmvc-Portlet: # {Portlet} 5$ xc $5 . 

(5) 数据 访问 /集成 (Data Access/Integration) 
Spring-JDBC: 提供 以 JDBC 访 问 数据 库 的 支持 ; 
Spring-TX: 提供 编程 式 和 声明 式 的 事务 支持 ; 
Spring-ORM: 提供 对 对 象 /关系 映射 技术 的 支持 ; 
Spring-OXM: 提供 对 对 象 /Xml 映射 技术 的 文 持 ; 
Spring-JMS: 提供 对 JMS 的 文 持 。 

2.Spring 的 生态 

Spring 发 展 到 现在 已 经 不 仅仅 是 Spring 框架 本 身 的 内 容 ， 














Spring 目前 提供 了 大 量 的 基于 Spring 的 项 目 ， 可 以 用 来 更 深入 
地 降低 我 们 的 开发 难度 ， 提 高 开发 效率 。 





目前 Spring 的 生态 里 主要 有 以 下 项 目 ， 我 们 可 以 根据 上 自己 


项 目的 需要 来 选择 使 用 相应 的 项 目 。 


的 文 


Spring Boot: 使 用 默认 开发 配置 来 实现 快速 开发 。 

Spring XD: 用 来 简化 大 数据 应 用 开发 。 

Spring Cloud: 为 分 布 式 系统 开发 提供 工具 集 。 

Spring Data: 对 主流 的 关系 型 和 NoSQL 数 据 库 的 文 持 。 
Spring Integration: 通过 消息 机 制 对 企业 集成 合式 〈EIP) 





To 


Spring Batch: 简化 及 优化 大 量 数据 的 批 处 理 操作 。 


Spring Security: 通过 认证 和 授权 保护 应 用 。 

Spring HATEOAS: 基于 HATEOAS 原 则 简化 REST 服 务 开 

Spring Social: 与 社交 网 络 API (如 Facebook、 新 浪 微 博 
等 ) 的 集成 。 

Spring AMQP: 对 基于 AMQP 的 消息 的 文 持 。 


Spring Mobile: 提供 对 手机 设备 检测 的 功能 ， 给 不 同 的 设 
备 返 回 不 同 的 页 面 的 支持 。 


Spring for Android: 主要 提供 在 Android 上 消费 RESTful 
API 的 功能 


Spring Web Flow: 基于 Spring MVC 提 供 基于 向 导 流 程式 的 
Web FHJT A . 


Spring Web Services: 提供 了 基于 协议 有 限 的 SOAP/Web 服 





wR 


Spring LDAP: 人 简化 使 用 LDAP 开 发 。 


Spring Session: 提供 一 个 API 及 实现 来 管理 用 户 会 话 信 
息 。 





1.2 Spring 项 目 局 速 搭建 








讲 到 项 目的 搭建 ， 也 许 有 些 读者 使 用 的 是 通过 开发 工具 新 
建 项 目 ， 然 后 将 项 目 所 要 依赖 的 第 三 方 jar 包 复制 到 下 和 面 的 类 路 
径 下 。 


我 们 现在 要 和 这 种 项 目 搭建 的 方式 说 拜拜 了 ， 因 为 上 述 搭 
建 方式 没有 第 三 方 类 库 的 依赖 关系 ， 在 导入 一 个 特定 的 jar 包 
时 ， 可 能 此 jar 包 还 依赖 于 其 他 的 jar 包 ， 其 他 的 jar 包 又 依赖 于 
更 多 的 jar 包 ， 这 也 是 我 们 平常 过 到 的 ClassNotFound 错 误 的 主 
要 原因 。 


为 了 解雇 上 述 问题 ， 我 们 急需 引入 一 个 项 目 构 建 工具 。 目 
前 主流 的 项 目 构 建 工 具有 : Ant、Maven、Gradle 等 。 本 书 中 我 
们 使 用 Maven 作 为 项 目 构建 工具 。 











1.2.1 Maven 人 简介 





Apache Maven 是 一 个 软件 项 目 管 理工 具 。 基 于 项 目 对 象 模 
型 (Project Object Model, POM) 的 概念 ，Maven 可 用 来 管理 
项 目的 依赖 、 编 译 、 文 档 等 信息 。 


使 用 Maven 管 理 项 目 时 ， 项 目 依 赖 的 jar 包 将 不 在 包含 在 项 
目 内 ， 而 是 集中 放置 在 用 户 目 录 下 的 .m2 文件 夹 下 。 




















1.2.2 ”Maven 安 装 


1. F% Maven 


= 根据 操作 系统 下 载 正 确 的 Maven 版 本 ， 并 解压 到 任意 目 


Maven 下载 地 址 : https://maven.apache.org/download.cgi. 
2. 配 置 Maven 


在 系统 属性 ~ 高 级 -环境 变量 中 分 别 配 置 M2_HOME 和 
Path， 如 图 1-2 所 示 。 


V 





























RAATS x 
变量 名 (N): M2_HOME 
SEV) 
RE 取消 

编辑 系统 变量 x 
变量 名 (N): Path 
SEEHB(V): hon27\Scripts;C:\\OpenBR-0.5.0-win64\bin;C:\Program Files\nodejs\;96M2_HOME%\bin | 

| wz || X 











图 1-2 配置 M2_ HOME 和 Path 


3. 测 试 安装 








在 控制 台 输 入 “mvn-v”， 获 得 如 图 1-3 所 示 信 息 表示 安装 成 
功 。 





图 1-3 ”安装 成 功 


1.2.3  Maveni‘/pom.xml 








Maven 是 基于 项 目 对 象 模型 的 概念 运作 的 ， 所 以 Maven 的 
项 目 都 有 一 个 pom.xml 用 来 管理 项 目的 依赖 以 及 项 目的 编译 等 
功能 。 


在 我 们 的 项 目 中 ， 我 们 主要 关注 下 面 的 元 系 。 


1.dependencies7t # 











<dependencies></dependencies>， 此 元 素 包 含 多 个 项 目 依赖 
需要 使 用 的 <dependency></dependency>。 


2.dependency 元 素 


<dependency></dependency> 内 部 通过 groupId、artifactId 以 
及 version 确 定 唯 一 的 依赖 ， 有 人 称 这 三 个 为 坐标 ， 代 码 如 下 。 


groupId: 组 织 的 唯一 标识 。 
artifactId: 项 目的 唯一 标识 。 
version: 项 目的 版 本 。 


<dependency> 
<groupId>org.springframework</groupId> 
<artifactId>spring-webmvc</artifactId> 
<version>4.1.5.RELEASE</version> 
</dependency> 


3. 变 量 定 义 


变量 定义 : <properties></properties> 可 定义 变量 在 





dependency 中 引用 ， 代 码 如 下 。 


<properties> <spring- 
framework.version>4.1.5.RELEASE</spring-framework.version> 
</properties> 

<dependency> 


«groupId»org.springframework«/groupId» 

<artifactId>spring-webmvc</artifactId> 

<version>${spring-framework.version}</version> 
</dependency> 


4.9 VETE 


Maven 提 供 了 编译 插件 ， 可 在 编译 插件 中 涉及 Java 的 编译 
级 别 ， 代 码 如 下 。 








<build> 
<plugins> 
<plugin> 
<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-compiler - 
plugin</artifactId> 
<version>2.3.2</version> 
<configuration> 
<source>1.7</source> 
<target>1.7</target> 
</configuration> 
</plugin> 
</plugins> 
</build> 
5.Maveniz E 7j 3X 


Maven 会 上 自动 根据 dependency 中 的 依赖 配置 ， 直 接 通过 互 
联网 在 Maven 中 心 库 下 载 相 关 依 赖 包 到 .m2 目录 下 ，.m2 目 录 下 


是 你 本 地 Maven 库 。 


如 果 你 不 知道 你 所 依赖 jar 包 的 dependency 怎 么 写 的 话 ， 推 
荐 到 http://mvnrepository.com 网 站 检索 。 


耕 Maven 中 心 库 中 没有 你 需要 的 jar 包 (如 Oracle〉， 你 需 
要 通过 下 面 的 Maven 命 令 打 到 本 地 Maven 库 后 应 用 即 可 ， 如 安 
装 Oracle 驱 动 到 本 地 库 : 








mvn install:install-file -DgroupId=com.oracle "- 
Dartifactid-ojdbci4" 
"-Dversion-10.2.0.2.0" "-Dpackaging=jar" 


Dfile=D:\ojdbc14. jar" 


1.2.4 Spring 项 目的 搭建 


1. 基 于 Spring Tool Suite 搭 建 


Spring Tool Suite (简称 STS) 是 Spring 官方 推出 的 基于 
Eclipse 的 开发 工具 ， 集 成 了 M2E (Maven Integration for 
Eclipse) ~ Spring IDE 等 插件 。 符 习惯 于 用 Eclipse 开发 项 目的 
话 ，STS 则 是 开发 Spring 项 目的 不 二 之 选 。 夺 你 当前 使 用 的 是 
常规 的 Eclipse， 请 安装 M2E 插 件 。STS 下 载 地 址 : 
https://spring.io/tools/sts/all. 


(1) 新 建 Maven 项 目 ， 如 图 1-4 所 示 。 


c New Maven Project 


New Maven project 


Select project name and location 





[v] Use default Workspace location 


[ ] Add project(s) to working set 


» Advanced 





图 1-4 ”新建 Maven 项 目 
(2) 输出 本 Maven 项 目的 坐标 值 ， 如 图 1-5 所 示 。 
(3) 在 STS 中 生成 如 图 1-6 所 示 结 构 的 项 目 。 


© New Maven Project 
| New Maven project 
Configure project 
Artifact 
Group Id: | com.wisely 
Artifact Id: highlight spring4 
Version: 0.0.1-SNAPSHOT 


Packaging: jar 





Name: [ 





Description: 


Parent Project 





Group Id: Í 
Artifact Id: 


| Version: 


| 
>» Advanced 











图 1-5 ”输出 坐标 值 


v yS highlight spring4 
G src/main/java 
(48 src/main/resources 


G src/test/java 


EÈ src/test/resources 


> BA JRE System Library [J2SE-1.5] 
^ (E src 

= target 

im] pom.xml 





图 1-6 项 目的 结构 
(4) 修改 pom.xml。 增 加 Spring 的 依赖 ， 添 加 编译 插件 ， 


将 编译 级 别 设置 为 1.7。 


<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi= 
instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0 


4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.wisely</groupId> 
<artifactId>highlight_spring4</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<properties> 
<java.version>1.7</java.version> 
</properties> 
<dependencies> 
<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-context</artifactId> 
<version>4.1.6.RELEASE</version> 
</dependency> 
</dependencies> 
<build> 
<plugins> 
«plugin» 


<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-compiler - 


plugin</artifactId> 
<version>2.3.2</version> 
<configuration> 
<source>${java.version}</source> 
<target>${java.version}</target> 
</configuration> 
</plugin> 
</plugins> 
</build> 
</project> 


(5) 更 新 项 目 。 单 击 项 目 右 键 - Maven — Update 
Project > highlight-spring4 — Maven 


Dependencies — Spring > expression-4.1.6RELEASE.jar, 41-7 


Bra. 


(8 src/main/Java 
(8 src/main/resources 
(8 src/test/java 
(8 src/test/resources 
v BA Maven Dependencies 
> ET spring-context-4.1.6.RELEASE jar - C Users wise 
> ( spring-aop-4.1.6.RELEASE jar - C:\Users\wisely\, 
> &9 aopalliance-1.0jar - C:\Users\wisely\.m2\reposit 
> Ge spring-beans-4.1.6.RELEASE jar - C:\Users\wisel) 
> ET spring-core-4.1.6.RELEASE Jar - C:\Users\wisely\. 
> (m commons-logging-1.2,jar - C Users wisely. m2 
> |i spring-expression-4.1.6.RELEASE jar - C:\Users\y 
> mà JRE System Library UavaSE-1.7] 
^ src 
(& target 
四 pom.xml 





图 1-7 更 新 项 目 
(6) 依赖 树 查看 ， 如 图 1-8 所 示 。 








M highlight spring4/pom.xml 23 Er 
Dependency Hierarchy [test] ferl ED 
Dependency Hierarchy © | 地 |$% Resolved Dependencies [3 000 3e 
v © spring-context : 4.1.6.RELEASE [compile] © aopalliance : 1.0 [compile] 
v © spring-aop : 4.1.6.RELEASE [compile] © commons-logging : 1.2 [compile] 
© aopalliance : 1.0 [compile] © spring-aop : 4.1.6.RELEASE [compile] 


O spring-beans : 4.1.6.RELEASE (omitted for cc 6 spring-beans : 4.1.6.RELEASE [compile] 

© spring-core : 4.1.6.RELEASE (omitted for con D spring-context : 4.1.6.RELEASE [compile] 
v © spring-beans : 4.1.6.RELEASE [compile] 

© spring-core : 4.1.6.RELEASE (omitted for con 
v ©) spring-core : 4.1.6.RELEASE [compile] 

© commons-logging : 1.2 [compile] 


© spring-core : 4.1.6.RELEASE [compile] 
© spring-expression : 4.1.6.RELEASE [compile] 


v © spring-expression : 4.1.6.RELEASE [compile] 
© spring-core : 4.1.6.RELEASE (omitted for con 




















[Overview Dependencies [Dependency Hierarchy | Effective POM pomaml | 


图 1-8 依赖 树 查 看 


























2.3£ IntelliJ IDEAS € 


IntelliJ IDEA 是 Java 最 优秀 的 开发 工具 : Dynes. Tes 
能 、 开 发 不 卡 顿 、 新 技术 支持 快 。 

IntelliJ | IDEA 分 为 社区 版 和 商业 版 ， 社 区 版 免费 ， 商 业 版 
功能 强大 。 商 业 版 提供 30 天 的 试用 。 

IntelliJ IDEA 下 载 地 址 : 


https://www.jetbrains.com/idea/download/. 





(1) 新 建 Maven 项 目 。 单 击 File New. Project = Maven, 
如 图 1-9 所 示 。 


(2) 输入 Maven 项 目 坐 标 值 ， 如 图 1-10 所 示 。 
(3) 选择 存储 路 径 ， 如 图 1-11 所 示 。 


9I New Project 





图 1-9 ”新 建 Maven 项 目 





图 1-10 ”输入 坐标 值 





图 1-11 选择 存储 路 径 


(4) 修改 pom.xml 文 件 ， 使 用 上 例 的 pom.xml 文 件 内 容 ， 
IDEA 会 开启 自动 导入 Maven 依 赖 包 功能 ， 如 图 1-12 所 示 。 


v hightlight_spring4 idea 


P 
e 
b 
2 
be 
be 
b 
EB 





图 1-12 ”开局 目 动 导 入 Maven 功 能 
(50 依赖 树 查 看 ， 如 图 1-13 所 示 。 


z 
w 
a 
3 
Xe) 
ov 
a 
a 





图 1-13 ”依赖 树 查 看 
3. 基 于 NetBeans 搭 建 


NetBeans 是 Oracle 官 方 推出 的 Java 开 发 工具 ， 下 载 地 址 如 
F: https://netbeans.org/downloads/. 


(1) 新 建 Maven 项 目 ， 如 图 1-14 所 示 。 





O #208 x 


T 选择 项 目 














A 选择 项 目 Q 过 滤器 (1): 
类 别 (C); 项 目 (P) : 
WD Java Web ^ 
: a Java EE JavaFX — 
i IMLS Web 应 用 程序 
DD Java ME KAR S ep 模块 
QB Jere card 企业 应 用 程序 
@ i 4 EE 
aven OSGi 
@ PHP e NetBeans 模块 
i [^7] Groovy NetBeans 应 用 程序 
© cæ» lg POM 项 目 
OD NetBeans 模块 db 基于 原型 的 项 目 
o- 样 例 v| [Ue 基于 现 有 POM 的 项 目 
#80): 
HERRERA. B “T-P” TERRE. 
使 用 Maven 的 简单 Java SE 应 用 程序 。 























上 一 步 (B) 下 一 步 > 完成 | 取消 | 帮助 (0 





图 1-14 ”新 建 Maven 项 目 
(2) 输入 Maven 坐 标 ， 如 图 1-15 所 示 。 








O #2 Java 应 用 程序 x 
oR 名 称 和 位 置 
n SAW): 。 hightlight spring 

项 目 位 置 (L):  C:\Users\wisely\Documents\NetBeansProjects 浏览 (0)..， 


项 目 文件 夹 (D): |wisely\Documents \NetBeansProjects\hightlight_springd 


工件 D(a): — hightlight springt 


组 ID(G): com.visely 
mE): 1. O-SHAPSHOT 
包 (P): com. wisely. hi ghtlight springt (可 选 ) 





< 上 一 步 @) 下 二 步 [ 完成) | 取消 帮助 (0 











1-15 ”输入 Maven 侍 标 


(3) 更 新 pom.xml， 如 图 1-16 所 示 。 


E- b highlight_spring4 
vE 源 包 
: BB co. wisely. hightlight_spring4 
Dla 依赖 关系 
-a spring-context-—4. 1.6. RELEASE. jar 

由 - fa aopalliance-1.0. jar 

&g- commons-logging-l.2. jar 

由 - (3 spring-aop-4. 1.6. RELEASE. jar 

g- es spring-beans-4. 1.6. RELEASE. jar 

H- [3l spring-core-4. 1.6. RELEASE. jar 

1-8 spring-expression-á. 1.6. RELEASE. jar 


a B Jove 依赖 关系 
m JDK 1.8 (GRA) 
d- ds 项 目 文件 





图 1-16 ”更 新 pom.xml 
(4) 依赖 树 查 看 ， 如 图 1-17 所 示 。 


图 pom.xml [highlight springs] X 


源 有 效 。 ”历史 记录 araw € a 


commons-logging aopalliance 
1.2 1.0 


spring-aop 
4.1.6.RELEASE 


spring-beans 
4.1.6.RELEASE 


spring-context 
4.1.6.RELEASE 


& highlight spring4 
0.0.1-SNAPSHO1 





图 1-17 ”依赖 树 查 看 


1.3 ”Spring 基础 配置 


Spring 框架 本 号 有 四 大 原则 : 

1) 使 用 POJO 进 行 轻 量 级 和 最 小 侵入 式 开 发 。 

2) 通过 依赖 注入 和 基于 接口 编程 实现 松 耦 合 。 

3) 通过 AOP 和 默认 习惯 进行 声明 式 编 程 。 

4) 使 用 AOP 和 模板 (template) 减少 模式 化 代码 。 
Spring 所 有 功能 的 设计 和 实现 都 是 基于 此 四 大 原则 的 。 











1.3.1 依赖 注入 


1. 点 睛 


我 们 经 常 说 的 控制 翻转 (Inversion of Control-IOC) 和 依赖 
注入 (dependency ”injection-DI〉 在 Spring 环 境 下 是 等 同 的 概 
念 ， 控 制 翻转 是 通过 依赖 注入 实现 的 。 所 谓 依赖 注入 指 的 是 容 
器 负责 创建 对 象 和 维护 对 象 间 的 依赖 和 关系， 而 不 是 通过 对 象 本 
E fü Boe gale meo B om Td. 


OBL A IY SE HIEN T RES. REL — RR HT SURE 
念 。 如 果 你 希望 你 的 类 具备 菜 项 功能 的 时 候 ， 是 继承 目 一 个 具 
有 此 功能 的 父 类 好 呢 ? 还 是 组 合 另 外 一 个 具有 这 个 功能 的 类 好 
呢 ? 答案 是 不 言 而 喻 的 ， 继 承 一 个 父 类 ， 子 类 将 与 父 类 耦合 ， 
组 合 男 外 一 个 类 则 使 厢 合 度 大 大 降低 。 






































Spring IoC 容 器 (ApplicationContext) 负责 创建 Bean， 并 通 
过 容器 将 功能 类 Bean 注 入 到 你 需要 的 Bean 中 。Spring 提 供 使 用 
xml、 注 解 、Java 配 置 、groovy 配 置 实现 Bean 的 创建 和 注入 。 


无 论 是 xml 配 置 、 注 解 配置 还 是 Java 配 置 ， 都 被 称 为 配置 元 
数据 ， 所 谓 元 数据 即 描述 数据 的 数据 。 元 数据 本 身 不 具备 任何 
可 执行 的 能 力 ， 只 能 通过 外 界 代 码 来 对 这 些 元 数据 行 解析 后 进 
行 一 些 有 意义 操作 。Spring 容 器 解析 这 些 配置 元 数据 进行 Bean 
初始 化 、 配 置 和 管理 依赖 。 


声明 Bean 的 注解 : 














。@Component 组 件 ， 没 有 明确 的 角色 。 

« (QServicefE MV 2537 3H EZ. (service) 使 用 。 

e (@Repository 在 数据 访问 层 (dao 层 ) 使 用 。 

。 (@Controller 在 展现 层 (MVC > Spring MVC) 使 用 。 


注入 Bean 的 注解 ， 一 般 情 况 下 通用 。 





。@Autowired: Spring 提供 的 注解 。 
e (2Inject: JSR-330 提 供 的 注解 。 
e @Resource: JSR-250 提 供 的 注解 。 


@Autowired、@Inject、@Resource 可 注解 在 set 方 法 上 或 者 
属性 上 ， 笔 者 习惯 注解 在 属性 上 ， 优 点 是 代码 更 少 、 层 次 更 清 
HT 


EATER EBean 4) Sa 10 AI RE A, Spring 
7 as Fez H AnnotationConfigA pplicationContext. 








2. 示 例 


(1) 编写 功能 类 的 Bean。 


package com.wisely.highlight spring4.chi.di; 
import org.springframework.stereotype.Service; 
QService //1 
public class FunctionService { 
public String sayHello(String word){ 
return "Hello " + word +" !"; 
J 


代码 解释 


使 用 @Service 注 解 声明 当前 FunctionService 类 是 Spring 管 
理 的 一 个 Bean。 其 中 ， 使 用 @Component、@Service、 
@Repository 和 @Controller 是 等 效 的 ， 可 根据 需要 选用 。 


(2) 使 用 功能 类 的 Bean。 





package com.wisely.highlight spring4.chi.di; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.stereotype.Service; 
QService //1 
public class UseFunctionService { 
QAutowired //2 
FunctionService functionService; 


public String SayHello(String word)( 
return functionService.sayHello(word); 
} 


代码 解释 


(使 用 @Service 注 解 声明 当前 UseFunctionService 类 是 
Spring 管 理 的 一 个 Bean。 


@ 使 用 @Autowired 将 FunctionService 的 实体 Bean 注 入 到 
UseFunctionService 中 ， 让 UseFunctionService 具 备 
FunctionService 的 功能 ， 此 处 使 用 JSR-330 的 @Inject 注 解 或 者 
JSR-250 的 @Resource 注 解 是 等 效 的 。 


(3) 配置 类 。 


package com.wisely.highlight spring4.chi.di; 

import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 
QConfiguration //1 

QComponentScan("com.wisely.highlight spring4.chi.di") //2 
public class DiConfig { 


J 


代码 解释 
(D@Configuration 声 明 当 前 类 是 一 个 配置 类 ， 在 后 面 1.3.2 
市 的 Java 配 置 中 有 更 详细 的 说 明 ; 


@ 使 用 @ComponentScan， 自 动 扫 描 包 名 下 所 有 使 用 
@Service、@Component、@Repository 和 @Controller 的 类 ， 并 
注册 为 Bean。 











(A) J&T: 


package com.wisely.highlight_spring4.ch1.di; 
import org.springframework.context.annotation.AnnotationConfi 
public class Main { 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context = 


new AnnotationConfigApplicationContext (DiC 
UseFunctionService useFunctionService = context.getBean(UseFu 
System. out.println(useFunctionService.SayHello("di") 


context.close(); 


代码 解释 


使 用 AnnotationConfigApplicationContext 作 为 Spring 容 
器 ， 接 受 输入 一 个 配置 类 作为 参数 ; 


@) 获 得 声明 配置 的 UseFunctionService 的 Bean。 
结果 如 图 1-18 所 示 。 





六 月 69，2815 3:03:50 F+org.spri 
ms: Refreshing org.springfra 
Hello world ! 

*A09, 2015 3:03:50 Frorg.spri 


æa: Closing org.springframewo 





1.3.2 Java 配置 


1. 点 睛 


Java 配 置 是 Spring “4.x 推 荐 的 配置 方式 ， 可 以 完全 蔡 代 xml 


配置 Java 配置 也 是 Spring Boot 推 荐 的 配置 方式 。 
Java 配 置 是 通过 @Configuration 和 @Bean 来 实现 的 。 








。(@Configuration 声 明 当 前 类 是 一 个 配置 类 ， 相 当 于 一 个 
Spring 配 置 的 xml 文 件 。 
。@Bean 注 解 在 方法 上 ， 声 明 当 前 方法 的 返回 值 为 一 个 


Bean 。 


本 书 通 篇 使 用 Java 配 置 和 注解 混合 配置 。 何 时 使 用 Java 配 
置 或 者 注解 配置 呢 ? 我 们 主要 的 原则 是 : 全 局 配置 使 用 Java 配 
置 〈 如 数据 库 相 关 配 置 、MVC 相 关 配 置 ) ， 业 务 Bean 的 配置 
使 用 注解 配置 (Service. (2Component. @Repository. 
@Controlle) 。 


本 节 只 演示 简单 的 Java 配 置 ， 全 书 各 个 章节 都 会 有 大 量 的 
Java 配 置 的 内 容 。 


2. 示 例 
(1) 编写 功能 类 的 Bean。 




















package com.wisely.highlight spring4.chi.javaconfig; 
//1 
public class FunctionService { 


public trang sayHello(String iA 
return "Hello " + word +" !" 


代码 解释 
QD) 此 处 没有 使 用 @Service 声 明 Bean。 


(2) 使 用 功能 类 的 Bean。 


package com.wisely.highlight spring4.chi.javaconfig; 


import com.wisely.highlight spring4.chi.javaconfig.FunctionSe 
//1 
public class UseFunctionService { 

S72 

FunctionService functionService; 


public void setFunctionService(FunctionService functionSe 


this.functionService - functionService; 
} 


public String SayHello(String word) { 
return functionService.sayHello(word); 
} 


代码 解释 

QD 此 处 没有 使 用 @Service 声 明 Bean。 

@) 此 处 没有 使 用 @Autowired 注 解 注 入 Bean。 
(3) 配置 类 。 


package com.wisely.highlight spring4.chi.javaconfig; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 


QConfiguration //1 
public class JavaConfig ( 
QBean //2 
public FunctionService functionService(){ 
return new FunctionService(); 
} 


@Bean 

public UseFunctionService useFunctionService(){ 
UseFunctionService useFunctionService - new UseFuncti 
useFunctionService.setFunctionService(functionService 
return useFunctionService; 


} 
// QBean 
// public UseFunctionService useFunctionService(FunctionServ 
{ //4 
// UseFunctionService useFunctionService = new UseFuncti 
// useFunctionService.setFunctionService(functionService 
// return useFunctionService; 
// } 
J 
b! JJ. 3 
代码 解释 


(使 用 @Configuration 注 解 表明 当前 类 是 一 个 配置 类 ， 这 
意味 着 这 个 类 里 可 能 有 0 个 或 者 多 个 @Bean 注 解 ， 此 处 没有 使 
用 包 扫 描 ， 是 因为 所 有 的 Bean 都 在 此 类 中 定义 了 。 


包 使 用 @Bean 注 解 声明 当前 方法 FunctionService 的 返回 值 
是 一 个 Bean，Bean 的 名 称 是 方法 名 。 


(3) 注 入 FunctionService 的 Bean 时 候 直 接 调 用 


functionService () 。 


(4) 男 外 一 种 注入 的 方式 ， 直 接 将 FunctionService 作 为 参数 
给 useFunctionService () ， 这 也 是 Spring 容 吉 提供 的 极 好 的 功 
能 。 在 Spring 容 器 中 ， 只 要 容器 中 存在 某 个 Bean， 就 可 以 在 男 
外 一 个 Bean 的 声明 方法 的 参数 中 写 入 。 


(4) 运行 。 














package com.wisely.highlight spring4.chi.javaconfig; 


import org.springframework.context.annotation.AnnotationConfi 
public class Main { 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context = 
new AnnotationConfigApplicationContext(Ja 
UseFunctionService useFunctionService = context.getB 


System.out.println(useFunctionService.SayHello("java 


context.close(); 


结果 如 图 1-19 所 示 。 


A809, 2015 3:03:09 F+org.springfra 
me: Refreshing org.springframework. 
Hello java contig ! 


*R09, 2015 3:03:09 Trorg.springfre 
信息 : Closing org.springframework.con 





1.3.3 AOP 


1. 点 睛 
AOP: 面 癌 切面 编程 ， 相 对 于 OOP 面 向 对 象 编 程 。 


Spring 的 AOP 的 存在 目的 是 为 了 解 簿 。AOP 可 以 让 一 组 类 
共享 相同 的 行为 。 在 OOP 中 只 能 通过 继承 类 和 实现 接口 ， 来 使 























代码 的 耦合 度 增 强 ， 且 类 继承 只 能 为 单 继 承 ， 阻 碍 更 多 行为 添 
加 到 一 组 类 上 ，AOP 弥 补 了 OOP 的 不 足 。 


Spring 文 持 AspectU 的 注解 式 切面 编程 。 
(1) 使 用 @Aspect 声 明 是 一 个 切面 。 


(2) 使 用 @After、@Before、@Around 定 义 建言 
(advice) ， 可 直接 将 拦截 规则 “〈 切 点 ) 作为 参数 。 


(3) 其 中 @After、@Before、@Around 参 数 的 拦截 规则 为 
JA (PointCut) ， 为 了 使 切 点 复 用 ， 可 使 用 @PointCut 专 门 定 
义 拦 截 规则 ， 然 后 在 @After、@Before、@Around 的 参数 中 调 
用 。 








(4) 其 中 符合 条 件 的 每 一 个 被 拦截 处 为 连接 点 
(JoinPoint) . 

本 节 示 例 将 演示 基于 注解 拦截 和 基于 方法 规则 拦截 两 种 方 
式 ， 演 示 一 种 模拟 记录 操作 的 日 志 系 统 的 实现 。 其 中 注解 式 拦 
截 能 够 很 好 地 控制 要 拦截 的 粒度 和 获得 更 丰富 的 信息 ，Spring 
本 和 号 在 事务 处 理 〈(@Transcational〉 和 数据 缓存 (@Cacheable 
等 ) 上 面 都 使 用 此 种 形式 的 拦截 。 

2.75 Pil 


(1) 添加 spring aop 支 持 及 AspectJ 依 赖 。 








<!-- Spring aop 


MEF --> 


<dependency> 


«groupId»org.springframework«/groupId» 
<artifactId>spring-aop 


</artifactId> 
<version>4.1.6.RELEASE</version> 
</dependency> 
<!-- aspectj 
支持 --> 
<dependency> 


«groupId»org.aspectj«/groupId» 
<artifactId>aspectjrt</artifactId> 
<version>1.8.5</version> 
</dependency> 
<dependency> 
«groupId»org.aspectj«/groupId» 
<artifactId>aspect jweaver 


</artifactId> 
<version>1.8.5</version> 
</dependency> 


(20 编写 拦截 规则 的 注解 。 


package com.wisely.highlight spring4.chi.aop; 


import java.lang.annotation.Documented; 
import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation.Target; 


QTarget(ElementType.METHOD) 
QRetention(RetentionPolicy.RUNTIME) 
QDocumented 
public @interface Action { 

String name(); 
J 


代码 解释 

这 里 讲 下 注解 ， 注 解 本 身 是 没有 功能 的 ， 就 和 xml 一 样 。 
注解 和 xml 都 是 一 种 元 数据 ， 元 数据 即 解释 数据 的 数据 ， 这 就 
是 所 谓 配 置 。 

注解 的 功能 来 自用 这 个 注解 的 地 方 。 

G) 编写 使 用 注解 的 被 拦截 类 。 








package com.wisely.highlight spring4.chi.aop; 
import org.springframework.stereotype.Service; 


@Service 

public class DemoAnnotationService { 
@Action(name=" 注 解 式 拦截 的 add 操 作 " ) 
public void add(){} 








(4) 编写 使 用 方法 规则 被 拦截 类 。 


package com.wisely.highlight spring4.chi.aop; 
import org.springframework.stereotype.Service; 
@Service 
public class DemoMethodService { 

public void add(){} 


(5) 编写 切面 。 


package com.wisely.highlight spring4.chi.aop; 
import java.lang.reflect.Method; 


import org.aspectj.lang.JoinPoint; 

import org.aspectj.lang.annotation.After; 

import org.aspectj.lang.annotation.Aspect; 
import org.aspectj.lang.annotation.Before; 
import org.aspectj.lang.annotation.Pointcut; 
import org.aspectj.lang.reflect.MethodSignature; 
import org.springframework.stereotype.Component; 


QAspect //1 
QComponent //2 
public class LogAspect { 


QPointcut("Qannotation(com.wisely.highlight spring4.chi.a 
public void annotationPointCut(){}; 


QAfter("annotationPointCut()") //4 
public void after(JoinPoint joinPoint) { 
MethodSignature signature - (MethodSignature) joi 
Method method - signature.getMethod(); 
Action action - method.getAnnotation(Action.class 
System. out.println ("ERF 





截 " + action.name()); //5 
} 


QBefore("execution(* com.wisely.highlight_spring4.ch1. 
(..))") 7/6 
public void before(JoinPoint joinPoint) { 
MethodSignature signature = (MethodSignature) joi 
Method method = signature.getMethod(); 
System.out,printlLn(" 方 法 规则 式 拦 





截 , "+method.getName()); 
} 


} 


代码 解释 

通过 @Aspect 注 解 声明 一 个 切面 。 

(2538 33 (9 ComponentiE JE UJ [fr] ARAN Spring 73-98 1 ER I] Bean » 
@ 通 过 @PointCut 注 解 声明 切 点 。 


由 通过 @After 注 解 声明 一 个 建言 ， 并 使 用 @PointCut 定 义 
的 切 点 。 


串通 过 反射 可 获得 注解 上 的 属性 ， 然 后 做 日 志 记 录 相 关 的 
操作 ， 下 面 的 相同 。 


通过 @Before 注 解 声 明 一 个 建言 ， 此 建言 直接 使 用 拦截 
规则 作为 参数 。 


(6) 配置 类 。 








package com.wisely.highlight spring4.chi.aop; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.EnableAspectJAu 


QConfiguration 
QComponentScan("com.wisely.highlight spring4.chi.aop") 


QEnableAspectJAutoProxy //1 
public class AopConfig ( 


j 


代码 解释 


(使 用 @EnableAspectJAutoProxy 注 解 开启 Spring 对 AspectJ 
代理 的 支持 。 


(7) J&T; 


package com.wisely.highlight_spring4.ch1.aop; 
import org.springframework.context.annotation.AnnotationConfi 
public class Main { 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context = 
new AnnotationConfigApplicationContext (Ao 
DemoAnnotationService demoAnnotationService = contex 
DemoMethodService demoMethodService = context.getBea 
demoAnnotationService.add(); 


demoMethodService.add(); 


context.close(); 


结果 如 图 1-20 所 示 。 


EG) Console 23 

«terminated» Main (11) [Java Application] Q 
*XA09, 2015 3:02:11 F+org.springfra 
m2: Refreshing org.springframework. 

注 等 式 关 过 Ser eeHaddse 


方法 规 刚 式 关 过 ,add 
*A09, 2015 3:02:11 下 于 org.springfra 
m2: Closing org.springframework.cont 





第 2 章 Spring 常用 配置 


2.1 Bean 的 Scope 


2.1.1 点 睛 
Scope 摘 述 的 是 Spring 容 器 如 何 新 建 Bean 的 实例 的 。Spring 
的 Scope 有 以 下 几 种 ， 通 过 @Scope 注 解 来 实现 。 


(1) Singleton: 一 个 Spring 容器 中 只 有 一 个 Bean 的 实例 ， 
此 为 Spring 的 默认 配置 ， 全 容 右 共享 一 个 实例 。 


(2) Prototype: 每 次 调用 新 建 一 个 Bean 的 实例 。 


(3) Request: Web 项 目 中 ， 给 每 一 个 http request 新 建 一 个 
Bean 实 例 。 


(4) Session: Web 项 目 中 ， 给 每 一 个 http session 新 建 一 个 
Bean 实 例 。 


(5) GlobalSession: 这 个 只 在 portal 应 用 中 有 用 ， 给 每 一 
个 global http session 新 建 一 个 Bean 实 例 。 


另外 ， 在 Spring Batch 中 还 有 一 个 Scope 是 使 用 
@StepScope， 我 们 将 在 批 处 理 一 节 介 绍 这 个 Scope。 


本 例 简单 演示 默认 的 singleton 和 Prototype， 分 别 从 Spring 容 
器 中 获得 2 次 Bean， 判 断 Bean 的 实例 是 否 相 等 。 











2.1.2 “示例 


(1) 编写 Singleton 的 Bean。 


package com.wisely.highlight_spring4.ch2.scope; 
import org.springframework.stereotype.Service; 


@Service //1 
public class DemoSingletonService { 


j 


代码 解释 
(默认 为 Singleton， 相 当 于 @Scope (“singleton”) . 
(2) 编写 Prototype 的 Bean。 


package com.wisely.highlight_spring4.ch2.scope; 


import org.springframework.context.annotation.Scope; 
import org.springframework.stereotype.Service; 


@Service 
@Scope("prototype")//1 
public class DemoPrototypeService { 


j 


代码 解释 


(声明 Scope 为 Prototype。 


(3) 配置 类 。 


package com.wisely.highlight_spring4.ch2.scope; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


@Configuration 


QComponentScan("com.wisely.highlight spring4.ch2.scope") 
public class ScopeConfig { 


j 


(4) iB4T. 


package com.wisely.highlight spring4.ch2.scope; 
import org.springframework.context.annotation.AnnotationConfi 
public class Main ( 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context - 


new AnnotationConfigApplicationContext(ScopeC 


DemoSingletonService si = context.getBean(DemoSingletonServic 
DemoSingletonService s2 - context.getBean(DemoSinglet 


DemoPrototypeService p1 
DemoPrototypeService p2 


context.getBean(DemoPrototy 
context.getBean(DemoPrototy 


System.out.println("si 与 Ss2 是 否 相 等 ; "+s1.equals(s2)); 
System.out.println("pi1 与 p2 是 否 相 等 ; "+p1.equals(p2)); 


context.close(); 


结果 如 图 2-1 所 示 。 


El Console X [$] Markers SẸ Pı 


<terminated> Main (12) [Java Appl 


A809, 2015 3:01:12 Frorg.sp 
me: Refreshing org.springfra 
sl1ss2£$&:55. true 

plsp2£z:5. false 

*A09, 2015 3:01:12 T^org.sp 
m2: Closing org.springfran 





图 2-1 运行 结果 


22 Spring EL 和 资源 调用 


2.2.1 AH 








Spring EL-Spring 表 达 式 语言 ， 文 持 在 xml 和 注解 中 使 用 表 
达 式 ， 类 似 于 JSP 的 EL 表达 式 语言 。 


Spring 开发 中 经 常 涉及 调用 各 种 资源 的 情况 ， 包 含 普 通 文 
件 、 网 址 、 配 置 文件 、 系 统 环境 变量 等 ， 我 们 可 以 使 用 Spring 
的 表达 式 语言 实现 资源 的 注入 。 

Spring 主要 在 注解 @Value 的 参数 中 使 用 表达 式 。 

本 节 演 示 实 现 以 下 几 种 情况 : 

(1) 注入 普通 字符 ; 
注入 操作 系统 属性 ; 

(3) 注入 表达 式 运 算 结 果 ; 
注入 其 他 Bean 的 属性 ; 
(50 注入 文件 内 容 ; 
(6) 注入 网 址 内 容 ; 
注入 属性 文件 。 














NAA 


(2 


NAA 


(4 


WY 


(7 


2.2.2 “示例 


(1) 准备 ， 增 加 commons-io 可 简化 文件 相关 操作 ， 本 例 
中 使 用 commons-io 将 fie 转换 成 字符 串 : 


<dependency> 
<groupId>commons-io</groupId> 
<artifactId>commons-io</artifactId> 
<version>2.3</version> 
</dependency> 


在 com.wisely.highlight_spring4.ch2.el 包 下 新 建 test.txt， 内 容 
随意 o 


7Ecom.wisely.highlight_spring4.ch2.el@, F 39r E 
test.properties, AAU F: 


book.author-zwangyunfei 
book.name=spring boot 


(2) 需 被 注入 的 Bean。 


package com.wisely.highlight_spring4.ch2.el; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.stereotype.Service; 


@Service 

public class DemoService { 
@Vvalue(" 其 他 类 的 属性 ") //1 
private String another; 





public String getAnother() { 
return another; 


public void setAnother(String another) { 
this.another = another; 
} 


代码 解释 
QD 此 处 为 注入 普通 字符 串 
(3) 演示 配置 类 。 


package com.wisely.highlight spring4.ch2.el; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


org. 
org. 


org 


org. 
org. 
org. 


org 


org. 
org. 
org. 


apache.commons.io.IOUtils; 
beans.factory.annotation.Autowired 
beans.factory.annotation.Value; 


springframework. 
.Springframework. 
springframework. 
springframework. 
springframework. 
.Springframework. 
springframework. 
springframework. 
springframework. 


QConfiguration 


QComponentScan("com.wisely. 
QPropertySource("classpath: 


public class ElConfig { 


context. 
context. 
context. 
.annotation.PropertySource; 
context. 


context 


annotation.Bean; 
annotation.ComponentScan; 
annotation.Configuration; 


support.PropertySourcesPla 


core.env.Environment; 
core.io.Resource; 


highlight spring4.ch2.e1") 
com/wisely/highlight spring4/ch2/e 


@Value("I Love You!") //1 
private String normal; 


@Value("#{systemProperties['os.name']}") //2 
private String osName; 


@Value("#{ T(java.lang.Math).random() * 100.0 }") //3 
private double randomNumber; 


@Value("#{demoService.another}") //4 
private String fromAnother; 


@Value("classpath:com/wisely/highlight_spring4/ch2/el/tes 
private Resource testFile; 


@Value("http://www.baidu.com") //6 


private Resource testUrl; 


@Value("${book.name}") //7 
private String bookName; 


@Autowired 


private Environment environment; //7 


@Bean //7 


public static PropertySourcesPlaceholderConfigurer proper 
return new PropertySourcesPlaceholderConfigurer(); 


j 


public void outputResource() { 


try { 


System. 
System. 
System. 
System. 


System. 
System. 
System. 
System. 


out. 
out. 
out. 
out. 


out. 
out. 
out. 
out. 


println(normal); 
println(osName); 
println(randomNumber); 
println(fromAnother); 


println(IOUtils.toString(testFile.getI 
println(IOUtils.toString(testUrl.getIn 
println(bookName); 

println(environment.getProperty("book. 


) catch (Exception e) { 
e.printStackTrace(); 


} 


代码 解释 


(注入 普通 字符 串 。 


书 注 入 操作 系统 属性 。 


(3 注入 表达 式 结果 。 


(4) 注 入 其 他 Bean 属 性 。 


(注入 文件 资源 。 

@ 注 入 网 址 资源 。 

QD 注入 配置 文件 。 

注入 配置 配件 需 使 用 @PropertySource 指 定 文 件 地 址 ， 若 使 
用 @Value 注 入 ， 则 要 配置 一 个 


PropertySourcesPlaceholderConfigurer 的 Bean。 注 意 ， 


@Value ("${book.name}") 使 用 的 是 “$”， 而 不 是 “#”。 
注入 Properties 还 可 从 Environment 中 获得 。 
(4) i&ÍT. 


package com.wisely.highlight_spring4.ch2.el; 
import org.springframework.context.annotation.AnnotationConfi 
public class Main { 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context = 
new AnnotationConfigApplicationContext(Re 
ElConfig resourceService = context.getBean(ElConfig. 


resourceService.outputResource(); 


context.close(); 


结果 如 图 2-2 所 示 。 
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图 2-2 运行 结 


2.3 Bean 的 初始 化 和 销毁 


2.3.1 AH 





在 我 们 实际 开发 的 时 候 ， 经 名 会 遇 到 在 Bean 在 使 用 之 前 或 
者 之 后 做 些 必 要 的 操作 ，Spring 对 Bean 的 生命 周期 的 操作 提供 
了 支持 。 在 使 用 Java 配 置 和 注解 配置 下 提供 如 下 两 种 方式 : 


(1) Java 配 置 方式 ;使 用 @Bean 的 initMethod 和 
destroyMethod〈 相 当 于 xml 配 置 的 init-method 和 destory- 
method) 。 





(2) 注解 方式 : 利用 JSR-250 的 @PostConstruct 和 
@PreDestroy. 


2.3.2 ”演示 


(1) 增加 JSR250 支 持 。 


<dependency> 
<groupId>javax.annotation</groupId> 
<artifactId>jsr250-api 


</artifactId> 
<version>1.0</version> 
</dependency> 


(2) 使 用 @Bean 形 式 的 Bean。 


package com.wisely.highlight_spring4.ch2.prepost; 
public class BeanWayService { 
public void init(){ 
System.out.println("QBean-init-method"); 


public BeanWayService() { 
super(); 
System,out,println(" 初 始 化 构造 函数 - 
BeanWayService"); 


y 

public void destroy(){ 
System.out.println("QBean-destory-method"); 

J 


(3) 使 用 JSR250 形 式 的 Bean。 


package com.wisely.highlight_spring4.ch2.prepost; 


import javax.annotation.PostConstruct; 
import javax.annotation.PreDestroy; 


public class JSR250WayService { 
QPostConstruct //1 
public void init(){ 
System.out.println("jsr250-init-method"); 


} 

public JSR250WayService() { 
super(); 
System.out.printlLn(" 初 始 化 构造 函数 -JSR250WayService'" ) ; 


J 

QPreDestroy //2 

public void destroy(){ 
System.out.println("jsr250-destory-method"); 

} 


代码 解释 

(D@PostConstruct， 在 构造 函数 执行 完 之 后 执行 。 
(@PreDestroy， 在 Bean 销 毁 之 前 执行 。 

(4) 配置 类 。 





package com.wisely.highlight_spring4.ch2.prepost; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


@Configuration 
QComponentScan("com.wisely.highlight spring4.ch2.prepost") 
public class PrePostConfig ( 


@Bean(initMethod="init",destroyMethod="destroy") //1 
BeanWayService beanWayService(){ 

return new BeanWayService(); 
} 


@Bean 

JSR250WayService jsr250WayService(){ 
return new JSR250WayService(); 

I 


代码 解释 


(DinitMethod 和 destroyMethod 指 定 BeanWayService 类 的 init 
和 destroy 方 法 在 构造 之 后 、Bean 销 毁 之 前 执行 。 





(5) 运行 。 


package com.wisely.highlight_spring4.ch2.prepost; 


import org.springframework.context.annotation.AnnotationConfi 
public class Main { 


public static void main(String[] args) { 
AnnotationConfigApplicationContext context = 
new AnnotationConfigApplicationContext(PrePos 


BeanWayService beanWayService = context.getBean(BeanW 
JSR250WayService jsr250WayService = context.getBean(J 


context.close(); 


结果 如 图 2-3 所 示 。 


六 月 8@9，2815 2:49:44 Forg.springframe 
m2: Refreshing org.springframework.con 
Mie Re-BeanWayService 
@Bean-init-method 
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*7A@9, 2015 2:49:44 F+org.springframe 
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2.4 Profile 


2.4.1 点 睛 





Profile 为 在 不 同 环境 下 使 用 不 同 的 配置 提供 了 文 持 《开发 
cr cene tessuti 例如 ， 数 据 
的 配置 ) 。 


(1) 通过 设 定 Environment 的 ActiveProfiles 来 设 定 当 前 
context 需 要 使 用 的 配置 环境 。 在 开发 中 使 用 @Profile 注 解 类 或 
者 方法 ， 达 到 在 不 同情 况 下 选择 实例 化 不 同 的 Bean。 


(2) 通过 设 定 jvm 的 spring.profiles.active 参 数 来 设置 配置 
环境 。 


(3) Web 项 目 设 置 在 Servlet 的 context parameter 中 。 
Servlet 2.5 及 以 下 : 








<servlet> 

<servlet -name>dispatcher</servlet -name> <servlet - 
class>org.springframework.web.servlet.DispatcherServlet</serv 
class> 


«init-param» 
<param-name>spring.profiles.active</param-name> 
<param-value>production</param-value> 

</init -param> 

</servlet> 


Servlet 3.04 UJ E: 


public class WebInit implements WebApplicationInitializer { 
QOverride 
public void onStartup(ServletContext container) throws Se 
container.setInitParameter("spring.profiles.default", 
} 


2.4.2 ”演示 
(1) 示例 Bean。 


package com.wisely.highlight_spring4.ch2.profile; 


public class DemoBean { 
private String content; 
public DemoBean(String content) { 
super(); 
this.content = content; 


j 


public String getContent() ( 
return content; 
} 


public void setContent(String content) { 
this.content = content; 
} 


(2) Profile 配 置 。 


package com.wisely.highlight_spring4.ch2.profile; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Profile; 


@Configuration 
public class ProfileConfig { 
@Bean 
@Profile("dev") //1 
public DemoBean devDemoBean() { 
return new DemoBean("from development profile"); 
} 


@Bean 
@Profile("prod") //2 
public DemoBean prodDemoBean() { 
return new DemoBean("from production profile"); 
} 


代码 解释 

(DProfile 为 dev 时 实例 化 devDemoBean。 

G@)Profile 为 prod 时 实例 化 prodDemoBean。 
(3) 运行 。 


package com.wisely.highlight_spring4.ch2.profile; 
import org.springframework.context.annotation.AnnotationConfi 
public class Main { 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context = 
new AnnotationConfigApplicationContext(); 
context.getEnvironment().setActiveProfiles("prod"); 


context.register(ProfileConfig.class);//2 
context.refresh(); //3 


DemoBean demoBean = context.getBean(DemoBean.class) 
System.out.println(demoBean.getContent()); 


context.close(); 


代码 解释 

QD 先 将 活动 的 Profile 设 置 为 prod。 

书后 置 注册 Bean 配 置 类 ， 不 然 会 报 Bean 未 定义 的 错误 。 
OE 

结果 如 图 2-4 所 示 。 


六 月 @9，2815 5:02:59 F+org.springtramewor 
信息 : Refreshing org.springframework.cont&a 
from production profile 
*A09, 2015 5:03:00 F+org.springframewor 
信息 : Closing org.springframework.context, 














将 context.getEnvironment () .setActiveProfiles (“prod”) 
修改 为 context.getEnvironment (2 .setActiveProfiles ("dev") , 


效果 如 图 2-5 所 示 。 





六 月 09，2615 5:09:00 F+org.springtramewor 
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图 2-5 ”修改 的 效果 


2.5 344 (Application Event) 


2.5.1 点睛 


Spring 的 事件 (Application Event) 为 Bean 与 Bean 之 间 的 消 
居 通 信和 提供 了 支持 。 当 一 个 Bean 处 理 完 一 个 任务 之 后 ， 希 望 男 
外 一 个 Bean 知 道 并 能 做 相应 的 处 理 ， 这 时 我 们 就 需要 让 另外 一 
个 Bean 监 听 当 前 Bean 所 发 送 的 事件 。 


Spring 的 事件 需要 遵循 如 下 流程 : 

(1) 自 定 义 事件 ， 集 成 ApplicationEvent。 

(2) 定义 事件 监听 器 ， 实 现 ApplicationListener。 
(3) 使 用 容器 发 布 事件 。 




















2.5.2 “示例 


(1) 自 定义 事件 。 


package com.wisely.highlight_spring4.ch2.event; 

import org.springframework.context.ApplicationEvent; 

public class DemoEvent extends ApplicationEvent{ 
private static final long serialVersionUID = 1L; 
private String msg; 


public DemoEvent(Object source,String msg) { 


super(source); 
this.msg = msg; 


j 


public String getMsg() { 
return msg; 
} 


public void setMsg(String msg) { 
this.msg = msg; 
} 


(2) 事件 监听 器 。 


package com.wisely.highlight_spring4.ch2.event; 


import org.springframework.context.ApplicationListener ; 
import org.springframework.stereotype.Component; 


@Component 
public class DemoListener implements ApplicationListener<Demo 


public void onApplicationEvent(DemoEvent event) {//2 
String msg = event.getMsg(); 


System. out.println("4&%(bean-demoListener ) 接 收 到 了 bean - 
demoPublisher 发 布 的 消息 :"+ msg); 


} 


代码 解释 
实现 ApplicationListener 接 口 ， 并 指定 监听 的 事件 类 型 。 








(2)(# FA onApplicationEvent 77 EX 3H SAE AT 22 5e NTH 
(3) 事件 发 布 类 。 


package com.wisely.highlight_spring4.ch2.event; 
import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.context.ApplicationContext; 
import org.springframework.stereotype.Component; 
@Component 
public class DemoPublisher { 
@Autowired 
ApplicationContext applicationContext; //1 


public void publish(String msg) { 
applicationContext.publishEvent(new DemoEvent(this, m 


代码 解释 

注入 ApplicationContext 用 来 发 布 事件 。 

@) 使 用 ApplicationContext 的 publishEvent 方 法 来 发 布 。 
(4) 配置 类 。 





package com.wisely.highlight_spring4.ch2.event; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


@Configuration 


QComponentScan("com.wisely.highlight spring4.ch2.event") 
public class EventConfig { 


} 


(5) 运行 。 


package com.wisely.highlight_spring4.ch2.event; 


import org.springframework.context.annotation.AnnotationConfi 


public class Main { 
public static void main(String[] args) { 


AnnotationConfigApplicationContext context = 
new AnnotationConfigApplicationContext (Ev 


DemoPublisher demoPublisher = context.getBean(DemoPu 
demoPublisher.publish("hello application event"); 


context.close(); 


结果 如 图 2-6 所 示 。 


六 月 89，2815 5:54:09 FF org.springframework.context.annotation.AnnotationConfigA 
信息 : Refreshing org.springframework.context.annotation.AnnotationConfigApplicati 
我 (bean-demoListener) 接 收 天 了 bean-demoPublisher 发 布 的 消息 :hello application event 

六 月 69，2815 5:54:09 TF org.springframework.context.annotation.AnnotationConfigA 
信息 : Closing org.springframework.context.annotation.AnnotationConfigApplicationC 











图 2-6 ”运行 结果 


第 3 章 = SpringmA ii 


3.1 Spring Aware 


3.1.1 点睛 








Spring 的 依赖 注入 的 最 大 亮点 就 是 你 所 有 的 Bean 对 Spring 容 
器 的 存在 是 没有 意识 的 。 即 你 可 以 将 你 的 容器 蔡 换 成 别 的 容 
at» "Google Guice， 这 时 Bean 之 间 的 耦合 度 很 低 。 

但 是 在 实际 项 目 中 ， 你 不 可 避免 的 要 用 到 Spring 容器 本 丑 
的 功能 资源 ， 这 时 你 的 Bean 必 须要 意识 到 Spring 容 器 的 存在 ， 
才能 调用 Spring 所 提供 的 资源 ， 这 就 是 所 谓 的 Spring Aware. 
其 实 Spring ” Aware 本 来 就 是 Spring 设 计 用 来 框架 内 部 使 用 的 ， 
AAEH f Spring Aware， 你 的 Bean 将 会 和 Spring 框架 耘 合 。 

Spring 提供 的 Aware 接 口 如 表 3-1 所 示 。 


表 3-1 Spring 提供 的 Aware 接 口 
































BeanNameAware 获得 到 容器 中 Bean 的 名 称 
BeanFactoryAware 获得 当前 bean factory， 这 样 可 以 调用 容器 的 服务 
ApplicationContextA ware* 当前 的 application context， 这 样 可 以 调用 容器 的 服务 
MessageSource Aware 获得 message source， 这 样 可 以 获得 文本 信息 
应 用 时 间 发 布 器 ， 可 以 发 布 事件 ，2.5 节 的 DemoPublisher 也 可 实现 这 个 接口 
ApplicationEventPublisherAware TIT 
ResourceLoaderA ware 获得 资源 加 载 器 ， 可 以 获得 外 部 资源 文件 








Spring Aware 的 目的 是 为 了 让 Bean 获 得 Spring 容器 的 服务 。 
为 ApplicationContext 接 口 集 成 了 MessageSource 接 口 、 


ApplicationEventPublisher 接 口 和 ResourceLoader 接 口 ， 所 以 
Bean 继 承 ApplicationContextAware 可 以 获得 Spring 容器 的 所 有 








服务 ， 但 原则 上 我 们 还 是 用 到 什么 接口 ， 就 实现 什么 接口 。 


3.1.2 “示例 


(1) 准备 。 在 com.wisely.highlight_spring4.ch3.aware 包 下 
新 建 一 个 test.txt， 内 容 随意 ， 给 下 面 的 外 部 资源 加 载 使 用 。 


(2) Spring Aware 演 示 Bean。 





package com.wisely.highlight_spring4.ch3.aware; 


import 


import 
import 
import 
import 
import 
import 


java.io. IOException; 


org. 
org. 
.springframework.context.ResourceLoaderAware; 
org. 
org. 
org. 


org 


@Service 
public class AwareService implements BeanNameAware, ResourceLo 


apache.commons.io.IOUtils; 
springframework.beans.factory.BeanNameAware; 


springframework.core.io.Resource; 
springframework.core.io.ResourceLoader; 
springframework.stereotype.Service; 


private String beanName; 
private ResourceLoader loader; 


@Override 
public void setResourceLoader(ResourceLoader resourceLoad 
this.loader = resourceLoader; 


j 


QOverride 
public void setBeanName(String name) (//3 
this.beanName - name; 


j 


public void outputResult(){ 
System.out.println("Bean 的 名 称 为 : " + beanName); 


Resource resource = 
loader .getResource("classpath:com/wisely/high 
try{ 


System.out.println("ResourceLoader Jn CEA 
A: " + IOUtils.toString(resource.getInputStream())); 


jcatch(IOException e){ 
e.printStackTrace(); 


j 
j 


代码 解释 

()S£ FE), BeanNameAware. ResourceLoaderAwarefZ[l, 374 
Bean 名 称 和 资源 加 载 的 服务 。 

(2)3£ Fh ResourceLoaderA ware jij Œ 5j setResourceLoader. 


(S.S: Fy BeanNameA ware ££; & 5j setBeanNameJj 1; , 
(3) WAX. 


package com.wisely.highlight_spring4.ch3.aware; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 
@Configuration 

QComponentScan("com.wisely.highlight spring4.ch3.aware") 
public class AwareConfig { 


j 


(4) 运行 。 


package com.wisely.highlight_spring4.ch3.aware; 
import org.springframework.context.annotation.AnnotationConfi 


public class Main { 
public static void main(String[] args) { 


AnnotationConfigApplicationContext context = 
new AnnotationConfigApplicationContext(AwareC 


AwareService awareService = context.getBean(AwareServ 
awareService.outputResult(); 


context.close(); 


结果 如 图 3-1 所 示 。 


六 月 10, 2015 10:41:00 LF org.springframework 
信息 : Refreshing org.springframework. context. 
Bean 的 避 称 为 : awareService 
ResourceLoader 各 载 的 交 件 内 容 为 : 111111 

六 月 19，2615 10:41:00 LF org.springframework 
信息 : Closing org.springframework.context.ann 











3.2 BAKE 


32d Ju 


EE 
H 


Spring 通 过 任务 执行 器 (TaskExecutor) 来 实现 多 线程 和 并 
发 编程 。 使 用 ThreadPoolTaskExecutor 可 实现 一 个 基于 线程 池 
的 TaskExecutor。 而 实际 开发 中 任务 一 般 是 非 阻 碍 的 ， 即 异步 
的 ， 所 以 我 们 要 在 配置 类 中 通过 @EnableAsync 开 局 对 异步 任 
务 的 文 持 ， 并 通过 在 实际 执行 的 Bean 的 方法 中 使 用 @Async 注 





解 来 声明 其 是 一 个 异步 任务 。 


3.2.2 “示例 


(1) 配置 类 。 


package com.wisely.highlight_spring4.ch3.taskexecutor; 


import 


import 
import 
import 
import 
import 
import 


java.util.concurrent.Executor; 


org. 
.Springframework. 
org. 
org. 
org. 
org. 


org 


springframework. 


springframework. 
springframework. 
springframework. 
springframework. 


QConfiguration 
QComponentScan("com.wisely. 
QEnableAsync //1 

public class TaskExecutorConfig implements AsyncConfigurer{// 


QOverride 
public Executor getAsyncExecutor() {//2 


aop.interceptor.AsyncUncaughtExcep 
context.annotation.ComponentScan; 
context.annotation.Configuration; 
scheduling.annotation.AsyncConfigu 
scheduling.annotation.EnableAsync; 
scheduling.concurrent.ThreadPoolTa 


highlight spring4.ch3.taskexecutor 


ThreadPoolTaskExecutor taskExecutor = new ThreadPool 
taskExecutor.setCorePoolSize(5); 
taskExecutor.setMaxPoolSize(10); 
taskExecutor.setQueueCapacity(25); 
taskExecutor.initialize(); 
return taskExecutor; 


j 


QOverride 

public AsyncUncaughtExceptionHandler getAsyncUncaughtExce 
return null; 

} 


代码 解释 
(利用 @EnableAsync 注 解 开 启 异 步 任务 支持 。 


@ 配 置 类 实现 AsyncConfigurer 接 口 并 重 写 getAsyncExecutor 
方法 ， 并 返回 一 个 ThreadPoolTaskExecutor， 这 样 我 们 就 获得 
了 一 个 基于 线程 池 TaskExecutor。 


(2) 任务 执行 类 。 


package com.wisely.highlight_spring4.ch3.taskexecutor; 


import org.springframework.scheduling.annotation.Async; 
import org.springframework.stereotype.Service; 

@Service 

public class AsyncTaskService { 


@Async //1 

public void executeAsyncTask(Integer i){ 
System.out.println(" 执 行 异步 任务 : "+i); 

} 


@Async 

public void executeAsyncTaskPlus(Integer 1){ 
System.out.println(" 执 行 异步 任务 +1: "+(i+1)); 

} 


代码 解释 








中 通 过 @Async 注 解 表明 该 方法 是 个 弄 步 方法 ， 如 来 注解 
在 类 级 别 ， 则 表明 该 类 所 有 的 方法 都 是 异步 方法 ， 而 这 里 的 方 
法 自动 被 注入 使 用 ThreadPoolTaskExecutor 作 为 TaskExecutor。 


(3) 运行 ， 


package com.wisely.highlight_spring4.ch3.taskexecutor; 


import org.springframework.context.annotation.AnnotationConfi 


public class Main { 


public static void main(String[] args) { 
AnnotationConfigApplicationContext context = 
new AnnotationConfigApplicationContext(Ta 


AsyncTaskService asyncTaskService = context.getBean( 

for(int i -0 ;i«10;i-*-*)( 
asyncTaskService.executeAsyncTask(i); 
asyncTaskService.executeAsyncTaskPlus(i); 


context.close(); 


结果 是 并 发 执行 而 不 是 顺序 执行 的 ， 如 图 3-2 所 示 。 


Hata tia: 3 
执行 异步 任务 +1: 4 
执行 异步 性 务 : 4 
执行 寞 步 性 务 +1: 5 
执行 寞 步 任 务 : 5 
执行 寻 步 任务 +1: 6 
执行 异步 任务 : 6 
执行 异步 任务 +1: 
执行 异步 任务 : 7 
执行 异步 任务 +1: 
执行 异步 任务: 8 
执行 寞 步 尾 务 +1: 
执行 异步 任务 : 9 
执行 异步 任务 +1: - 
执行 异步 任务 : e 
执行 异步 任务 : 1 


图 3-2 ”运行 结果 





3.3 theses 


3.3.1 AH 





从 Spring 3.1 开 始 ， 计 划 任 务 在 Spring 中 的 实现 变 得 异常 的 
简单 。 首 先 通 过 在 配置 类 注解 @EnableScheduling 来 开局 对 计 
划 任 务 的 文 持 ， 然 后 在 要 执行 计划 任务 的 方法 上 注解 
@Scheduled， 声 明 这 是 一 个 计划 任务 。 


Spring 通 过 @Scheduled 文 持 多 种 类 型 的 计划 任务 ， 包 含 
cron、fixDelay、fixRate 等 。 





3.8.2 “示例 


(1) 计划 任务 执行 类 。 


package com.wisely.highlight_spring4.ch3.taskscheduler; 


import java.text.SimpleDateFormat; 
import java.util.Date; 


import org.springframework.scheduling.annotation.Scheduled; 
import org.springframework.stereotype.Service; 


@Service 
public class ScheduledTaskService { 


private static final SimpleDateFormat dateFormat = new 
@Scheduled(fixedRate = 5000) //1 


public void reportCurrentTime() { 
System.out.println(" 每 隔 五 秒 执行 一 


iX " + dateFormat.format(new Date())); 


j 


@Scheduled(cron = "02811? * *" ) //2 
public void fixTimeExecution(){ 
System.out.println( "esse 
间 " + dateFormat.format(new Date() )+" 执 行 " ) ， 


代码 解释 


(通过 @Scheduled 声 明 该 方法 是 计划 任务 ， 使 用 fixedRate 
属性 每 隔 固定 时 间 执 行 。 


@ 使 用 cron 属 性 可 按照 指定 时 间 执 行 ， 本 例 指 的 是 每 天 11 
点 28 分 执行 ; cron 是 UNIX 和 类 UNIX (Linux) 系统 下 的 定时 
任务 。 


(2) 配置 类 。 








package com.wisely.highlight_spring4.ch3.taskscheduler; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.scheduling.annotation.EnableSchedu 


@Configuration 

QComponentScan("com.wisely.highlight spring4.ch3.taskschedule 
@EnableScheduling //1 

public class TaskSchedulerConfig { 


代码 解释 


通过 @EnableScheduling 注 解 开 局 对 计划 任务 的 支持 。 
(3) 运行 。 


package com.wisely.highlight_spring4.ch3.taskscheduler; 
import org.springframework.context.annotation.AnnotationConfi 
public class Main { 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context = 
new AnnotationConfigApplicationContext(Ta 


j 
j 


结果 如 图 3-3 所 示 。 


每 隔 五 种 执行 一 次 11:27:57 
在 指定 时 间 11:28:66 执 行 
每 隅 五 神 执 行 一 灾 11:28:02 
每 隔 五 种 执行 一 交 11:28:07 
布 五 种 执行 一 次 11:28:12 
CAPT TA 11:28:17 


uma HhfT— 11:28:27 
Betti 7— A 11:28:32 
&ansblhfq—X 11:28:37 


f 
P 
f 
隔 五 种 执行 一 次 11:28:22 
f 
3j 
P 
PEA Ph — R 11:28:42 





3.4 条 件 注 解 @Conditional 
3.4.1 ”点睛 


在 2.4 节 学 到 ， 通 过 活动 的 profile， 我 们 可 以 获得 不 同 的 
Bean. Spring 4 提供 了 一 个 更 通用 的 基于 条 件 的 Bean 的 创建 ， 
即使 用 @Conditional 注 解 。 


@Conditional 根 据 满 足 茶 一 个 特定 条 件 创建 一 个 特定 的 
Bean。 比 方 说 ， 当 茶 一 个 jar 包 在 一 个 类 路 径 下 的 时 候 ， 目 动 配 
置 一 个 或 多 个 Bean; 或 者 只 有 攻 个 Bean 被 创建 才 会 创建 男 外 一 
个 Bean。 忌 的 来 说 ， 束 是 根据 特定 条 件 来 控制 Bean 的 创建 行 
为 ， 这 样 我 们 可 以 利用 这 个 特性 进行 一 些 目 动 的 配置 。 


在 Spring Boot 中 将 会 大 量 应 用 到 条 件 注解 ， 更 多 内 容 见 本 
书 6.1 节 。 


下 面 的 示例 将 以 不 同 的 操作 系统 作为 条 件 ， 我 们 将 通过 实 
现 Condition 接 口 ， 并 重 写 其 matches 方 法 来 构造 判断 条 件 。 和 若 
在 Windows 系 统 下 运行 程序 ， 则 输出 列表 命令 为 dir;， ATE 
Linux 操 作 系 统 下 运行 程序 ， 则 输出 列表 命令 为 ]s。 























3.4.2 ”示例 
1. 判 断 条 件 定义 


(1) 判定 windows 的 条 件 。 


package com.wisely.highlight_spring4.ch3.conditional; 
import org.springframework.context.annotation.Condition; 
import org.springframework.context.annotation.ConditionContex 
import org.springframework.core.type.AnnotatedTypeMetadata; 
public class WindowsCondition implements Condition { 

public boolean matches(ConditionContext context, 


AnnotatedTypeMetadata metadata) { 
return context.getEnvironment().getProperty("os.name" 


(2) 判定 Linux 的 条 件 。 


package com.wisely.highlight_spring4.ch3.conditional; 
import org.springframework.context.annotation.Condition; 
import org.springframework.context.annotation.ConditionContex 
import org.springframework.core.type.AnnotatedTypeMetadata; 
public class LinuxCondition implements Condition { 

public boolean matches(ConditionContext context, 


AnnotatedTypeMetadata metadata) { 
return context.getEnvironment().getProperty("os.name" 


2. 不 同系 统 下 Bean 的 类 
(1) 接口 。 


package com.wisely.highlight_spring4.ch3.conditional; 


public interface ListService { 
public String showListCmd(); 
J 


(2) Windows 下 所 要 创建 的 Bean 的 类 。 


package com.wisely.highlight_spring4.ch3.conditional; 
public class WindowsListService implements ListService { 


@Override 

public String showListCmd() { 
return "dir"; 

} 


(3) Linux 下 所 要 创建 的 Bean 的 类 。 


package com.wisely.highlight_spring4.ch3.conditional; 
public class LinuxListService implements ListService{ 


@Override 

public String showListCmd() { 
return "ls"; 

j 


3. 配 置 类 


package com.wisely.highlight_spring4.ch3.conditional; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Conditional; 
import org.springframework.context.annotation.Configuration; 


@Configuration 
public class ConditionConifg { 
@Bean 
@Conditional(WindowsCondition.class) //1 
public ListService windowsListService() { 
return new WindowsListService(); 


j 


QBean 

@Conditional(LinuxCondition.class) //2 

public ListService linuxListService() { 
return new LinuxListService(); 

} 


代码 解释 
QD 通过 @Conditional 注 解 ， 符 合 Windows 条 件 则 实例 化 


windowsListService. 


GO 通过 @Conditional 注 解 ， 符 合 Linux 条 件 则 实例 化 
linuxListService. 


package com.wisely.highlight spring4.ch3.conditional; 
import org.springframework.context.annotation.AnnotationConfi 
public class Main ( 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context - 
new AnnotationConfigApplicationContext(Condit 
ListService listService - context.getBean(ListService 
System.out.println(context.getEnvironment().getProper 


+ "系统 下 的 列表 命令 为 : " 


+ listService.showListCmd()); 


结果 如 图 3-4 和 图 3-5 所 示 。 


六 月 10, 2015 3:21:45 FF org.spring 
信息 : Refreshing org.springframework 
Windows 8.1 系 统 下 的 列表 命令 为 : dir 


六 月 18，2815 3:21:45 下 午 org.spring 
信息 : Closing org.springframework.co 





图 3-4 Windows 下 列表 命令 


六 月 18，2815 5:53:39 FF org.spring 
信息 : Refreshing org.springframewor 
Linux 系 统 下 的 列表 命令 为 : ls 


六 月 10, 2015 5:53:40 FF org.spring 
信息 : Closing org.springframework.cq 





图 3-5 ”Linux 下 列表 命令 


35 组 合 注解 与 元 注解 
3.5.1 点 睛 


从 Spring “2 开始 ， 为 了 啊 应 JDK ”1.5 推 出 的 注解 功能 ， 
Spring 开始 大 量 加 入 注解 来 蔡 代 xml 配 置 。Spring 的 注解 主要 用 
来 配置 注入 Bean， 切 面相 关 配 置 〈@Transactional) 。 随 着 注 
解 的 大 量 使 用 ， 尤 其 相同 的 多 个 注解 用 到 各 个 类 中 ， 会 相当 哆 
哑 。 这 就 是 所 谓 的 模板 代码 ， 是 Spring 设 计 原 则 中 要 消除 的 代 
AF, 


所 谓 元 注解 其 实 就 是 可 以 注解 到 别 的 注解 上 的 注解 ， 被 注 
解 的 注解 称 之 为 组 合 注解 、 是 可 能 有 点 掏 口 ， 体 会 含义 最 重 
要 ) ， 组 合 注 解 具 备 元 注解 的 功能 。Spring 的 很 多 注解 都 可 以 
@Configuration 就 是 一 个 组 合 @Component 注 解 ， 表 明 这 个 类 其 
实 也 是 一 个 Bean。 


我 们 前 面 的 章节 里 大 量 使 用 @Configuration 和 
@ComponentScan 注 解 到 配置 类 上 ， 如 果 你 跟着 本 书 一 直 在 戊 
代码 的 话 是 不 是 觉得 已 经 有 点 麻烦 了 呢 ? 下 耐 我 将 这 两 个 元 注 
i NE 这 样 我 们 只 需 写 一 个 注解 就 可 以 表示 两 
注解。 









































3.5.2 “示例 


(1) 示例 组 合 注解 。 


package com.wisely.highlight_spring4.ch3.annotation; 
import java.lang.annotation.Documented; 

import java.lang.annotation.ElementType; 

import java.lang.annotation.Retention; 

import java.lang.annotation.RetentionPolicy; 

import java.lang.annotation.Target; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


@Target(ElementType. TYPE) 
QRetention(RetentionPolicy.RUNTIME) 
@Documented 

@Configuration //1 

@ComponentScan //2 

public @interface WiselyConfiguration { 


String[] value() default {}; //3 


代码 解释 

QD 组 合 @Configuration 元 注解 。 
(22H 4 @ComponentScan suit f# © 
OF sti value XK. 


(2) 演示 服务 Bean。 


package com.wisely.highlight_spring4.ch3.annotation; 
import org.springframework.stereotype.Service; 


@Service 
public class DemoService { 


public void outputResult(){ 
System.out.println(" 从 组 合 注解 配置 照样 获得 的 pean'" ) ; 




















(3) PACER 


package com.wisely.highlight_spring4.ch3.annotation; 


@wiselyConfiguration("com.wisely.highlight_spring4.ch3.annota 
public class DemoConfig { 


j 


代码 解释 


使 用 @WiselyConfiguration 组 合 注解 蔡 代 @Configuration 
fli(g ComponentScan. 





(4) 运行 。 


package com.wisely.highlight_spring4.ch3.annotation; 
import org.springframework.context.annotation.AnnotationConfi 
public class Main { 
public static void main(String[] args) { 
AnnotationConfigApplicationContext context = 
new AnnotationConfigApplicationContext (DemoCo 
DemoService demoService = context.getBean(DemoServic 


demoService.outputResult(); 


context.close(); 


结果 如 图 3-6 所 示 。 





RA 10, 2015 6:41:30 FF org.sprin 
信息 : Refreshing org.springframewo! 


具 组 合 注 解 本 十 照 样 获得 的 bean 
RA 10, 2015 6:41:30 FF org.sprin 
信息 : Closing org.springframework.: 





图 3-6 ”运行 结果 


3.6”@Enable* 注 解 的 工作 原理 


在 本 章 的 第 一 部 分 我 们 通过 : 
@EnableAspectJAutoProxy 开 局 对 AspectJ 目 动 代理 的 文 


@EnableAsync 开 启 异 步 方法 的 文 持 。 
@EnableScheduling 开 启 计划 任务 的 支持 。 

在 第 二 部 分 我 们 通过 : 

@EnableWebMvc 开 启 Web MVC 的 配置 支持 。 
在 第 三 部 分 我 们 通过 : 


@EnableConfigurationProperties 开 启 对 
@ConfigurationProperties 注 解 配置 Bean 的 支持 。 


@EnableJpaRepositories 开 局 对 Spring Data JPA Repository 的 
文 持 。 


@EnableTransactionManagement 开 局 注解 式 事务 的 文 持 。 
(@EnableCaching 开 局 注解 式 的 缓存 文 持 。 
通过 人 简单 的 @Enable* 来 开局 一 项 功能 的 文 持 ， 从 而 避免 自 


己 配 置 大 量 的 代码 ， 大 大 降低 使 用 难度 。 那 么 这 个 神奇 的 功能 
的 实现 原理 是 什么 呢 ? 我 们 一 起 来 研究 一 下 。 








通过 观察 这 些 @Enable* 注 解 的 源码 ， 我 们 发 现 所 有 的 注解 
都 有 一 个 @Import 注 解 ，@Import 是 用 来 导入 配置 类 的 ， 这 也 
就 意味 着 这 些 自动 开启 的 实现 其 实 是 导入 了 一 些 目 动 配置 的 
Bean。 这 些 导 入 的 配置 方式 主要 分 为 以 下 三 种 类 型 。 




















3.6.1 第 一 类 : 直接 导入 配置 类 


@Target(ElementType. TYPE) 
QRetention(RetentionPolicy.RUNTIME) 
QImport(SchedulingConfiguration.class) 
@Documented 

public @interface EnableScheduling { 

} 





直接 导入 配置 类 SchedulingConfiguration， 这 个 类 注解 了 
@Configuration， 且 注册 了 一 个 scheduledAnnotationProcessor 的 
Bean, jJh34n F: 


QConfiguration 
QRole(BeanDefinition.ROLE INFRASTRUCTURE) 
public class SchedulingConfiguration ( 


QBean(name = TaskManagementConfigUtils.SCHEDULED ANNOTATI 

QRole(BeanDefinition.ROLE INFRASTRUCTURE) 

public ScheduledAnnotationBeanPostProcessor scheduledAnno 
return new ScheduledAnnotationBeanPostProcessor(); 

} 


3.6.2 第 二 类 : 依据 条 件 选 择 配 置 类 


@Target(ElementType. TYPE) 

QRetention(RetentionPolicy.RUNTIME) 

@Documented 

QImport(AsyncConfigurationSelector.class) 

public Qinterface EnableAsync { 

Class<? extends Annotation» annotation() default Annotation.c 
boolean proxyTargetClass() default false; 
AdviceMode mode() default AdviceMode.PROXY; 
int order() default Ordered.LOWEST PRECEDENCE; 


AsyncConfigurationSelector 通 过 条 件 来 选择 需要 导入 的 配 


置 类 ，AsyncConfigurationSelector 的 根 接口 为 ImportSelector， 
这 个 接口 需 重 写 selectImports 方 法 ， 在 此 方法 内 进行 事先 条 件 
判断 。 此 例 中 ， 若 adviceMode 为 PORXY， 则 返回 
ProxyAsyncConfiguration 这 个 配置 类 ， 知 activeMode 为 








ASPECTJ， 则 返回 AspectJAsyncConfiguration 配 置 类 ， 源 码 如 


public class AsyncConfigurationSelector extends AdviceModeImp 


private static final String ASYNC EXECUTION ASPECT CONFIG 
"org.springframework.scheduling.aspectj.AspectJAs 


QOverride 
public String[] selectImports(AdviceMode adviceMode) { 
switch (adviceMode) { 
case PROXY: 
return new String[] { ProxyAsyncConfiguration 
case ASPECTJ: 
return new String[] { ASYNC_EXECUTION_ASPECT_ 
default: 
return null; 


3.6.3 ”第 三 类 : 动态 注册 Bean 


@Target(ElementType. TYPE) 

QRetention(RetentionPolicy.RUNTIME) 

@Documented 

@Import (Aspect JAutoProxyRegistrar.class) 

public @interface EnableAspectJAutoProxy { 
boolean proxyTargetClass() default false; 

J 


AspectJAutoProxyRegistrarSz Ji] f 
ImportBeanDefinitionRegistrar}# L1, ImportBean 
DefinitionRegistrar 的 作用 是 在 运行 时 上 自动 添加 Bean 到 已 有 的 配 
置 类 ， 通 过 重 写 方法 : 





registerBeanDefinitions(AnnotationMetadata importingClassMeta 





其 中 ，AnnotationMetadata 参 数 用 来 获得 当前 配置 类 上 的 注 
解 ; BeanDefinitionRegistry 人 参数 用 来 注册 Bean。 源 人 码 如 下 : 








class AspectJAutoProxyRegistrar implements ImportBeanDefiniti 
QOverride 
public void registerBeanDefinitions( 
AnnotationMetadata importingClassMetadata, BeanDe 


AopConfigUtils.registerAspectJAnnotationAutoProxyCrea 


AnnotationAttributes enableAJAutoProxy - 
AnnotationConfigUtils.attributesFor(importing 
if (enableAJAutoProxy.getBoolean("proxyTargetClass")) 
AopConfigUtils.forceAutoProxyCreatorToUseClassPro 
J 


3.7 ”测试 
3.731 点睛 


测试 是 开发 工作 中 不 可 缺少 的 部 分 。 单 元 测试 只 针对 当前 
开发 的 类 和 方法 进行 测试 ， 可 以 简单 通过 模拟 依赖 来 实现 ， 对 
运行 环境 没有 依赖 ;但 是 仅仅 进行 单元 测试 是 不 够 的 ， 它 只 能 
验证 当前 类 或 方法 能 人 否 正常 工作 ， 而 我 们 想 要 知道 系统 的 各 个 
部 分 组 合 在 一 起 是 否 能 正常 工作 ， 这 就 是 集成 测试 存在 的 意 
ber 


集成 测试 一 般 需要 来 自 不 同 层 的 不 同 对 象 的 交互 ， 如 数据 
库 、 网 络 连接 、IoC 容 融 等 。 其 实 我 们 也 经 名 通过 运行 程序 ， 
然后 通过 目 己 操作 来 完成 类 似 于 集成 测试 的 流程 。 集 成 测试 为 
我 们 提供 了 一 种 无 须 部 获 或 运行 程序 来 完成 验证 系统 各 部 分 是 
个 能 正和 党 协同 工作 的 能 


Spring 通过 Spring TestContex Framework 对 集成 测试 提供 项 
级 文 持 。 它 不 依赖 于 特定 的 测试 框架 ， 既 可 使 用 Junit， 也 可 使 
用 TestNG。 


基于 Maven 构 建 的 项 目 结构 默认 有 关于 测试 的 目录 : 
src/test/java 〈 测 试 代码 ) ~ src/test/resources 〈 测 试 资源 ) ， 区 
Al T src/main/java 〈 项 目 源码 ) 、src/main/resources (项 目 资 
源 ) 。 


Spring 提供 了 一 个 SpringJUnit4ClassRunner 类 ， 它 提供 了 
Spring TestContext Framework 的 功能 。 通 过 
@ContextConfiguration 来 配置 Application Context， 通 过 









































@ActiveProfiles 确 定 活动 的 profile。 


在 使 用 了 Spring 测试 后 ， 我 们 前 面 的 例子 的 “运行 ?部 分 都 
可 以 用 Spring 测 试 来 检验 功能 能 合 正 常 运作 。 


集成 测试 涉及 程序 中 的 各 个 分 层 ， 本 布 只 对 简单 配置 的 
Application ”Context 和 在 测试 中 注入 Bean 做 演示 ， 在 本 书 第 二 
部 分 和 第 三 部 分 会 对 Spring 测试 做 更 多 的 讲述 。 








3.7.2 “示例 


1. 准 备 
增加 Spring 测 试 的 依赖 包 到 Maven: 


<!-- Spring test 支持 --> 

<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-test</artifactId> 
<version>${spring-framework.version}</version> 

</dependency> 

<dependency> 
<groupId>junit</groupId> 
<artifactId>junit</artifactId> 
<version>4.11</version> 

</dependency> 


2. 业 务 代 码 
在 src/main/java 下 的 源码 : 


package com.wisely.highlight_spring4.ch3.fortest; 


public class TestBean { 


private String content; 


public TestBean(String content) { 
super(); 
this.content = content; 


} 


public String getContent() { 
return content; 
} 


public void setContent(String content) { 
this.content = content; 
J 


3. 配 置 类 
在 src/main/java 下 的 源码 : 


package com.wisely.highlight_spring4.ch3.fortest; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Profile; 
@Configuration 
public class TestConfig { 

@Bean 

@Profile("dev" ) 

public TestBean devTestBean() { 

return new TestBean("from development profile"); 
I 


QBean 
QProfile("prod") 
public TestBean prodTestBean() { 
return new TestBean("from production profile"); 
} 


Alin 
在 src/test/java 下 的 源码 : 


package com.wisely.highlight_spring4.ch3.fortest; 


import org.junit.Assert; 

import org.junit.Test; 

import org.junit.runner.RunWith; 

import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.test.context.ActiveProfiles; 
import org.springframework.test.context.ContextConfiguration; 
import org.springframework.test.context.junit4.SpringJUnit4Cl 


QRunWith(SpringJUnit4ClassRunner.class) //1 
@ContextConfiguration(classes = {TestConfig.class}) //2 
@ActiveProfiles("prod") //3 
public class DemoBeanIntegrationTests { 

QAutowired //4 

private TestBean testBean; 


QTest //5 
public void prodBeanShouldInject(){ 
String expected - "from production profile"; 


String actual - testBean.getContent(); 
Assert.assertEquals(expected, actual); 


代码 解释 


(CDSpringJUnit4ClassRunner 在 JUnit 环 境 下 提供 Spring 
TestContext Framework 的 功能 。 


CO@ContextConfiguration 用 来 加 载 配置 
ApplicationContext， 其 中 classes 属 性 用 来 加 载 配置 类 。 


(3)@ActiveProfiles 用 来 声明 活动 的 profile。 





(4) 可 使 用 普通 的 @Autowired 注 入 Bean。 


加 测试 代码 ， 通 过 JUnit 的 Assert 来 校 验 结果 是 否 和 预期 一 


N7Y 


致 。 
结果 如 图 3-7 所 示 。 
#2 Spring Explorer gu JUnit 23 


a” 月 | & g 
Finished after 0.284 seconds 





Runs: 1/ @ Errors: CH Failures: ( | 





» Bi com.wisely.highlight spri = Failure Trace 





图 3-7 测试 结 
将 @ActiveProfiles (“prod”) AA 
@ActiveProfiles (“dev”) ， 演 示 测 试 不 能 通过 的 情景 ， 如 图 3- 
8 所 示 。 
#2 Spring Explorer gu JUnit 23 


上 个 旺角 | 久久 
Finished after 0.327 seconds 





Runs: 1/ B Errors: CB Failures: * mE 


v HE com.wisely.highlight spri = 
i) prodBeanShouldInjex 


Failure Trace EP 





org,junit.ComparisonFailure: 
at com.wisely.highlight_spri 


at org.springframework.tes 





图 3-8 ”演示 测试 不 能 通过 的 情景 


第 二 部 分 “点 睛 Spring MVC 4.x 


第 4 章 Spring MVC 基 础 


也 许 你 还 在 问 为 什么 要 用 Spring MVC, Struts 2.x 不 才 是 主 
流 吗 ? 看 SSH 的 概念 多 火 ! 其 实 很 多 初学 者 混 消 了 一 个 概念 ， 
SSH 实 际 上 指 的 是 Struts 1.x+Spring+Hibernate， 这 个 概念 已 经 
有 十 几 年 的 历史 了 。 在 Struts 1.x 的 时 代 ，Struts 1.x 是 当之无愧 
的 MVC 框 架 的 霸主 ， 但 是 在 新 的 MVC 框 染 涌 现 的 时 代 ， 形 式 

已经 完全 不 是 这 样 的 了 ，Struts 2.x 借 助 了 Struts 1.x 的 好 名 声 ， 
让 国内 开发 者 认为 Struts 2.x 是 霸主 继任 者 《其 实 两 者 在 技术 上 
， 导 致 国内 程序 员 大 多 数学 习 基 于 Struts 2.x 的 框 

» MRA ISB HR f 28H (Struts 

2; xs Spring*Hibernate) 整合 开发 。 


一 起 看 看 世界 范围 内 到 诬 是 什么 状况 吧 ， 请 看 下 面 的 调 碍 


统计 。 


Zeroturnaround (知名 热 部 署 软件 JRebel 厂 商 ) 统计 如 图 4-1 
PAAR o 




















Web frameworks in use * 


Vaadin 


Google Web Toolkit 





图 4-1 JRbel 厂 商 统计 
从 图 4-1 可 以 看 出 ，Spring MVC 的 市 场 占有 率 是 40%， 而 


Struts 2 只 有 可 怜 的 6%， 况 然 只 比 骨灰 级 的 Struts 1 高 那么 一 点 
占 


vitalflux.com 对 2014 一 2015 年 度 10 佳 Web 框 架 排 名。 
前 10 名 没有 Struts 2 的 身影 ， 前 五 名 为 : 
1.Spring MVC 








2.Grails 

3.Play 

4.Spring Boot 

5. Vaadin 

说 了 这 人 么 多 ， 不 过 是 为 了 大 家 更 有 信心 地 学 习 Spring 


MVC, Spring MVC 是 目前 Java Web 框 架 当 之 无 愧 的 霸主 。 


4.1 Spring MVC 概述 


说 到 Spring MVC， 不 得 不 先 来 谈 谈 什么 是 MVC， 它 和 三 
层 架 构 是 什么 关系 。 可 能 很 多 读者 都 会 抢答 : 


MVC: Model+View+Controller (数据 模型 + 视图 + 控制 
an) s 


> 42h): Presentation tier+Application tier+Data tier 〈 展 


现 层 + 应 用 层 + 数据 访问 层 ) 。 


那 MVC 和 三 层 架 构 有 什么 关系 昵 ? 在 我 面试 程序 员 的 时 
候 ， 经 常会 有 面试 者 告诉 我 : MVC 的 M 就 是 数据 访问 层 、V 就 
是 展现 层 、C 就 是 应 用 层 。 怎 么 样 ? 听 上 去 是 不 是 好 像 很 有 道 
理 ? 


但 是 实际 上 MVC 只 存在 三 层 架构 的 展现 屋 ，M 实 际 上 是 数 
据 模 型 ， 是 包含 数据 的 对 象 。 在 Spring MVC 里， 有 一 个 专门 
的 类 叫 Model， 用 来 和 V 之 间 的 数据 交互 、 传 值 ;，V 指 的 是 视图 
页 面 ， 包 含 JSP、freeMarker、Velocity、Thymeleaf、Tile 等 ;C 
当然 就 是 控制 器 〈Spring MVC 的 注解 @Controller 的 类 ) 。 


在 本 书 我 很 抱歉 地 告诉 大 家 ， 本 书 将 不 会 介绍 太 多 View 层 
的 知识 ， 只 会 简单 地 使 用 JSP 和 jstl 作 为 演示 ， 因 为 Spring MVC 
文 持 的 模板 引擎 太 多 了 ， 我 们 会 在 7.1 节 专门 介绍 Spring Boot 推 
nn 本 章 关 注 Spring MVC 在 实际 开发 中 的 各 
种 配置 。 


三 层 架构 是 整个 应 用 的 架构 ， 是 由 Spring 框架 负责 管 
的 。 ice 吉 构 中 都 有 Service 层 、DAO 层 ， 这 两 个 反馈 在 












































应 用 层 和 数据 访问 层 。 
弄 清 MVC 和 三 层 架 构 的 关系 对 我 们 理解 Spring MVC 和 进 
行 Web 开 发 至 关 重 要 。 


Spring MVC 使 我 们 可 以 简单 地 开发 灵活 且 松 耦 合 的 Web 项 
目 ， 本 章 我 们 将 关注 与 基于 注解 和 Java 配 置 的 零 配置 〈 无 xml 
配置 ) 的 Spring MVC 开 发 。 





4.2 Spring MVC 项 目 快 速 搭 建 
42.1 点睛 


Spring MVC 提 供 了 一 个 DispatcherServlet 来 开发 Web 应 用 。 
在 Servlet 2.5 及 以 下 的 时 候 只 要 在 web.xml 下 配置 <servlet> 元 素 
即 可 。 但 我 们 在 本 节 将 使 用 Servlet 3.0+ 无 web.xml 的 配置 方 
式 ， 在 Spring MVC 里 实现 WebApplicationInitializer 接 口 便 可 实 
现 等 同 于 web.xml 的 配置 。 


下 面 我 们 将 基于 Maven 搭 建 零 配置 的 Spring 。 MVC 原型 项 
目 ， 开 发 工具 相关 的 内 容 这 里 将 不 再 提 及 。 











4.2.2 “示例 


1. 构 建 Maven 项 目 


pom.xml 内 容 : 


«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi- 
instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0 
4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.wisely</groupId> 
<artifactId>highlight_springmvc4</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<packaging>war</packaging> 


<properties> 
<!-- Generic properties --> 
<java.version>1.7</java.version> 


<project.build.sourceEncoding>UTF - 
8</project.build.sourceEncoding> 
<project.reporting.outputEncoding>UTF- 
8</project. reporting. outputEncoding> 
<!-- Web --> 
<jsp.version>2.2</jsp.version> 
<jstl.version>1.2</jstl.version> 
<servlet.version>3.1.0</servlet.version> 
<!-- Spring --> 
<spring-framework.version>4.1.5.RELEASE</spring- 
framework.version> 
<!-- Logging --> 
<logback.version>1.0.13</logback.version> 
<slf4j.version>1.7.5</slf4j.version> 
</properties> 


<dependencies> 
<dependency> 
«groupId»javax«/groupId» 
<artifactId>javaee-web-api</artifactId> 
<version>7 .0</version> 
<scope>provided</scope> 
</dependency> 


<!-- Spring MVC --> 

<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-webmvc</artifactId> 
<version>${spring-framework.version}</version> 

</dependency> 


<!-- 其 他 web 依赖 --» 

<dependency> 
«groupId»javax.servlet«/groupId» 
<artifactId>jstl</artifactId> 
<version>${jstl.version}</version> 

</dependency> 

<dependency> 
«groupId»javax.servlet«/groupId» 
<artifactId>javax.servlet-api</artifactId> 
<version>${servlet.version}</version> 
<scope>provided</scope> 

</dependency> 

<dependency> 
«groupId»javax.servlet.jsp«/groupId» 
<artifactId>jsp-api</artifactId> 
<version>${jsp.version}</version> 
<scope>provided</scope> 


</dependency> 


<!-- Spring and Transactions --> 

<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-tx</artifactId> 
<version>${spring-framework.version}</version> 

</dependency> 


«1-- 使 用 SLF4J 和 LogBack 作 为 日 志 --> 

<dependency> 
«groupId»org.slf4j«/groupId» 
<artifactId>slf4j-api</artifactId> 
<version>${slf4j.version}</version> 

</dependency> 

<dependency> 
«groupId»10g4j«/groupId» 
<artifactId>log4j</artifactId> 
<version>1.2.16</version> 

</dependency> 

<dependency> 
«groupId»org.slf4j«/groupId» 
<artifactId>jcl-over-slf4j</artifactId> 
<version>${slf4j.version}</version> 

</dependency> 

<dependency> 
«groupId»ch.qgos.logback«/groupId» 
<artifactId>logback-classic</artifactId> 
<version>${logback.version}</version> 

</dependency> 

<dependency> 
<groupId>ch.qos.logback</groupId> 
<artifactId>logback-core</artifactId> 
<version>${logback.version}</version> 

</dependency> 

<dependency> 
<groupId>ch.qos.logback</groupId> 
<artifactId>logback-access</artifactId> 
<version>${logback.version}</version> 

</dependency> 

</dependencies> 


<build> 
<plugins> 
<plugin> 
«groupId»org.apache.maven.plugins«c/groupId» 
<artifactId>maven-compiler - 
plugin</artifactId> 


<version>2.3.2</version> 
<configuration> 
<source>${java.version}</source> 
<target>${java.version}</target> 
</configuration> 
</plugin> 
<plugin> 
<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-war -plugin</artifactId> 
<version>2.3</version> 
<configuration> 
<failOnMissingwebXml>false</failOnMissing 
</configuration> 
</plugin> 
</plugins> 
</build> 
</project> 


2. H SALE. 


fEsrc/main/resources H3* F,  3r£&logback.xml/H KMA H 
m , 内 容 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<configuration scan="true" scanPeriod="1 seconds"> 
«contextListener class="ch.qos.logback.classic.jul.LevelC 
<reset JUL>true</reset JUL> 


</contextListener> 
<jmxConfigurator/> 
<appender name="console" class="ch.qos.logback.core.Conso 
<encoder> 
<pattern>logbak: %d{HH:mm:ss.SSS} %logger{36} - % 
</encoder> 
</appender> 
«logger name="org.springframework.web" level="DEBUG"/> 
= 1 eS 


<root level="info"> 
<appender-ref ref="console"/> 
</root> 
</configuration> 


代码 解释 

(将 org.springframework.web 包 下 的 类 的 日 志 级 别 设置 为 
DEBUG， 我 们 开发 Spring ”MVC 经 常 出 现 和 参数 类 型 相关 的 
4XX 错 误 ， 设 置 此 项 我 们 会 看 到 更 详细 的 错误 信息 。 

3.1 AN R TT 


在 Src/main/resources 下 建立 views 目 录 ， 并 在 此 目录 下 新 建 
index.jsp， 内 容 如 下 : 


<%@ page language-"java" contentType="text/html; charset-UTF- 


8 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "- 
//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/ 
<html> 
<head> 
<meta http-equiv-"Content- 


Type" content="text/html; charset=UTF-8"> 
<title>Insert title here</title> 
</head> 
<body> 
<pre> 
Welcome to Spring MVC world 
</pre> 
</body> 
</html> 


代码 解释 


此 处 也 许 读 者 会 奇怪 ， 为 什么 页 面 不 放 在 Maven 标 准 的 
src/main/webapp/WEB-INF 下 ， 此 处 这 样 建 的 主要 目的 是 让 大 
家 就 悉 Spring Boot 的 页 面 习 惯 的 放置 方式 ，Spring Boot 的 页 面 
就 放置 在 src/main/resources 下 。 





4.Spring MVC 配 置 


package com.wisely.highlight_springmvc4; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


@Configuration 
@EnablewebMvc 
QComponentScan("com.wisely.highlight springmvc4") 
public class MyMvcConfig{ 
QBean 
public InternalResourceViewResolver viewResolver()( 
InternalResourceViewResolver viewResolver - new Inter 
viewResolver.setPrefix("/WEB-INF/classes/views/"); 
viewResolver.setSuffix(".jsp"); 
viewResolver.setViewClass(JstlView.class); 
return viewResolver; 


代码 解释 


此 处 无 任何 特别 ， 只 是 一 个 普通 的 Spring 配置 类 。 这 里 我 
们 配置 了 一 个 JSP 的 ViewResolver， 用 来 映射 路 径 和 实际 页 面 
的 位 置 ， 其 中 ，Q@EnableWebMvc 注 解 会 开启 一 些 默 认 配 置 ， 
如 一 些 ViewResolver 或 者 MessageConverter 等 。 


在 此 处 要 特别 解释 一 下 Spring MVC 的 ViewResolver， 这 是 
Spring MVC 视 图 (JSP 下 就 是 html) 演 染 的 核心 机 制 ，Spring 
MVC 里 有 一 个 接口 叫做 ViewResolver (我 们 的 ViewResolver 都 
实现 该 接口 ) ， 实 现 这 个 接口 要 重 写 方法 
resolveViewName O) ， 这 个 方法 的 返回 值 是 接口 View， 而 
View 的 职员 就 是 使 用 model、request、response 对 象 ， 并 将 泻 染 
(不 一 定 是 html， 可 能 是 json、xml、pdf) 返回 给 浏览 

。 在 4.5.2 节 我 们 会 介绍 更 多 关于 ViewResolver 的 内 容 。 


可 能 读者 对 路 径 前 绥 配 置 为 /WEB-INEF/classes/views/ 有 些 奇 

















怪 ， 怎 么 和 我 开发 的 目录 不 一 致 ? 因为 看 到 的 页 面 效 果 是 运行 
时 而 不 是 开发 时 的 代码 ， 运 行 时 代码 会 将 我 们 的 页 面 自动 编译 
到 /WEB-INF/classes/views/ 下 ， 图 4-2 是 运行 时 的 目录 结构 ， 这 
样 我 们 就 能 理解 前 级 为 什么 写成 这 样 ， 在 Spring Boot 中 ， 我 们 
将 使 用 Thymeleaf 作 为 模板 ， 因 而 不 需要 这 样 的 配置 。 











wtpwebapps » highlight_springmvc4 » WEB-INF » classes » views 


名 称 修改 日 期 


index.jsp 2015/6/12 13:18 JSP 文件 








图 4-2 ”运行 时 的 目录 结构 
5.Web 配 置 


package com.wisely.highlight_springmvc4; 


import javax.servlet.ServletContext; 
import javax.servlet.ServletException; 
import javax.servlet.ServletRegistration.Dynamic; 


import org.springframework.web.WebApplicationInitializer; 
import org.springframework.web.context.support.AnnotationConf 
import org.springframework.web.servlet.DispatcherServlet; 


public class WebInitializer implements WebApplicationInitiali 


QOverride 
public void onStartup(ServletContext servletContext) 
throws ServletException ( 
AnnotationConfigWebApplicationContext ctx - new Annot 
ctx.register(MyMvcConfig.class); 
ctx.setServletContext(servletContext); //2 


Dynamic servlet = servletContext.addServlet("dispatch 
servlet.addMapping("/"); 
servlet.setLoadOnStartup(1); 


代码 解释 


(DWebApplicationlnitializerzé Spring? 4t H 2E Me A Servlet 
3.0+ 配 置 的 接口 ， 从 而 实现 了 蔡 代 web.xml 的 位 置 。 实 现 此 接 
口 将 会 自动 被 SpringServletContainerInitializer 〈 用 来 局 动 
Servlet 3.0% 48) 获取 到 。 


@ 新 建 WebApplicationContext， 注 册 配 置 类 ， 并 将 其 和 当 
前 servletContext 关 联 。 


(3) 注 册 Spring MVC 的 DispatcherServlet。 


6. 人 简单 控制 器 


package com.wisely.highlight_springmvc4.web; 

import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.ResponseBody; 


@Controller//1 
public class HelloController { 


@RequestMapping("/index")//2 
public String hello(){ 


return "index"; //3 


代码 解释 
利用 @Controller 注 解 声明 是 一 个 控制 髓 。 


@ 利 用 @RequestMapping 配 置 URL 和 方法 之 间 的 映射 。 


@@ 通 过 上 面 ViewResolver 的 Bean 配 置 ， 返 回 值 为 index， 说 
明 我 们 的 页 面 放 置 的 路 径 为 /WEB-INF/classes/views/index.jsp。 
7. 运 行 


将 程序 部 晋 到 Tomcat 中 ， 局 动 Tomcat， 并 访问 
http://localhost: 8080/highlight_springmvc4/index， 如 图 4-3 所 
ZN o 








-OAN O localhost 
NH Fiia M histo E3Gis Muri M HardWa M Resource M Solution 23 Tools 








Welcome to Spring MWC world 





图 4-3 ”将 程序 部 署 到 Tomcat 


4.3 Spring MVC 的 常用 注解 
4.3.1 点睛 


Spring MVC% HLA F JLE ME o 
(1) @Controller 


@Controller 注 解 在 关上， 表明 这 个 类 是 Spring MVC 里 的 
Controller， 将 其 声明 为 Spring 的 一 个 Bean，Dispatcher Servlet 
会 自动 扫 摘 注解 了 此 注解 的 类 〈 这 里 和 我 们 在 1.3.3 节 演示 用 注 
解 作为 拦截 方式 的 例子 原理 类 似 ) ， 并 将 Web 请 求 映 射 到 注解 
了 @RequestMapping 的 方法 上 。 这 里 特别 指出 ， 在 声明 普通 
Bean 的 时 候 ， 使 用 @Component、@Service、@Repository 和 和 
@Controller 是 等 同 的 ， 因 为 @Service、@Repository、 
@Controller 都 组 合 了 @Compoment 元 注解 ， 但 在 Spring MVC 声 
明 控 制 器 Bean 的 时 候 ， 只 能 使 用 @Controller。 


(2) @RequestMapping 





@RequestMapping 注 解 是 用 来 映射 Web 请 求 〈 访 问 路 径 和 
参数 ) 、 处 理 类 和 方法 的 。@RequestMapping 可 注解 在 类 或 方 
法 上 。 注 解 在 方法 上 的 @RequestMapping 路 径 会 继承 注解 在 类 
上 的 路 径 ，@RequestMapping 文 持 Servlet 的 request 和 response 作 
为 参数 ， 也 支持 对 request 和 response 的 媒体 类 型 进行 配置 。 


(3) @ResponseBody 
@ResponseBody 文 持 将 返回 值 放 在 response 体 内 ， 而 不 是 











返回 一 个 页 面 。 我 们 在 很 多 基于 Ajax 的 程序 的 时 候 ， 可 以 以 此 
回 数据 而 不 是 页 面 ; 此 注解 可 放置 在 返回 值 前 或 者 方法 


(4) @RequestBody 





(@RequestBody 人 允许 request 的 参数 在 request 体 中 ， 而 不 是 在 
直接 链接 在 地 址 后 面 。 此 注解 放置 在 参数 前 


(5) @PathVariable 


@PathVariable 用 来 接收 路 径 参 数 ， 如 /news/001， 可 接收 
001 作 为 参数 ， 此 注解 放置 在 参数 前 。 


(6) @RestController 


@RestController 是 一 个 组 合 注解 ， 组 合 了 @Controller 和 
(@ResponseBody， 这 束 意 味 着 当 你 只 开发 一 个 和 页 面 交 互 数 据 
的 控制 的 时 候 ， 雷 要 使 用 此 注解 。 奉 没有 此 注解 ， 要 想 实现 上 
述 功 能 ， 则 需 自 己 在 代码 中 加 @Controller 和 @ResponseBody 两 
注解 。 





下 面 的 示例 将 演示 这 几 个 注解 的 使 用 。 
4.3.2 “示例 
1. 传 值 类 


A 添加 jackson 及 相关 依赖 ， 获 得 对 象 和 json 或 xml 之 间 的 转 


<! - -对 json 和 xm1 格 式 的 支持 - -> 


<dependency> 


«groupId»com.fasterxml.jackson.dataformat«/groupI 
<artifactId>jackson-dataformat -xml</artifactId> 
<version>2.5.3</version> 

</dependency> 


这 里 特别 指出 ， 在 实际 项 目 中 ， 我 们 其 实 主要 文 持 json 数 
据 ， 没 必要 同时 支持 json 和 xml， 因 为 json 比 xml 更 简洁 。 由 于 
JavaScript 的 广泛 使 用 ，json 成 为 最 推荐 的 格式 ， 在 这 种 情况 
下 ， 我 们 的 依赖 包 如 下 〈 上 面 的 依赖 包含 下 面 的 依赖 ) : 


<dependency> 
<groupId>com.fasterxml.jackson.core</groupId> 
<artifactId>jackson-databind</artifactId> 
<version>2.5.3</version> 

</dependency> 





此 类 用 来 演示 获取 request 对 象 参数 和 返回 此 对 象 到 


response: 


package com.wisely.highlight_springmvc4.domain; 


public class DemoObj { 
private Long id; 
private String name; 


public DemoObj() { // 1 
super(); 


} 

public DemoObj(Long id, String name) { 
super(); 
this.id = id; 
this.name = name; 


} 
public Long getId() { 
return id; 


J 
public void setId(Long id) { 


this.id = id; 


} 
public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 
} 


代码 解释 
Qjackson 对 对 象 和 json 做 转换 时 一 定 需要 此 空 构造 。 


package com.wisely.highlight_springmvc4.web.ch4_3; 
import javax.servlet.http.HttpServletRequest; 


import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.PathVariable; 
import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.ResponseBody; 


import com.wisely.highlight springmvc4.domain.DemoObj; 


QController // 1 
QRequestMapping("/anno") //2 
public class DemoAnnoController ( 


@RequestMapping(produces =  "text/plain;charset-UTF- 
8") // 3 
public @ResponseBody String index(HttpServletRequest requ 
return "url:" + request.getRequestURL() + " can acces 
} 


@RequestMapping(value = "/pathvar/{str}", produces = "tex 
8")// 5 
public @ResponseBody String demoPathVar(@PathVariable Str 
HttpServletRequest request) { 
return "url:" + request.getRequestURL() + " can acces 


j 


QRequestMapping(value - "/requestParam", produces - "text 
8") //6 
public QResponseBody String passRequestParam(Long id, 
HttpServletRequest request) { 


return "url:" + request.getRequestURL() + " can acces 
} 
@RequestMapping(value = "/obj", produces = "application/j 
8")//7 
@ResponseBody //8 
public String passObj(DemoObj obj, HttpServletRequest req 


return "url:" + request.getRequestURL( ) 


+ " can access, obj id: " + obj.getId()+" 
} 
@RequestMapping(value = { "/name1", "/name2" }, produces 
8")//9 


public @ResponseBody String remove(HttpServletRequest req 


return "url:" + request.getRequestURL() + " can acces 


代码 解释 
(Dg Controller? ft F5 B Jl 2i Ze — A 32: s o 


(2)@RequestMapping (“/anno”) 映射 此 类 的 访问 路 径 





是 /anno。 


(3) 此 方法 未 标注 路 径 ， 因 此 使 用 类 级 别 的 路 径 /anno; 








produces 可 定制 返回 的 response 的 媒体 类 型 和 字符 集 ， 或 需 返 回 
值 是 json 对 象 ， 则 设置 produces=“application/json; 
charset=UTF-8”， 在 后 面 的 章节 我 们 会 演示 此 项 特性 。 


由 演示 可 接受 HttpServletRequest 作 为 参数 ， 当 然 也 可 以 接 
受 HttpServletReponse 作 为 参数 。 此 处 的 @ReponseBody 用 在 返 
回 值 前 面 。 


演示 接受 路 径 参 数 ， 并 在 方法 参数 前 结合 @PathVariable 
使 用 ， 访 问 路 径 为 /anno/pathvar/xx。 


(@) 演 示 常 规 的 request 参 数 获取 ， 访 问 路 径 
为 /anno/requestParam? id=1。 


CO 演示 解释 参数 到 对 象 ， 访 问 路径 为 /anno/obj? 


id=1&name=xx. 
@I@ReponseBody 也 可 以 用 在 方法 上 。 
@) 演 示 上 映射 不 同 的 路 径 到 相同 的 方法 ， 访 问 路 径 


为 /anno/mamel 或 /anno/name2。 


3.@RestController 演 示 


package com.wisely.highlight_springmvc4.web.ch4_3; 


import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RestController 


import com.wisely.highlight springmvc4.domain.DemoObj; 


QRestController //1 
QRequestMapping("/rest") 
public class DemoRestController ( 


QRequestMapping(value = "/getjson", produces= 
{"application/json;charset=UTF-8"}) //2 
public DemoObj getjson (DemoObj obj){ 
return new DemoObj(obj.getid()*1, obj.getName( -*" yy") 
} 
QRequestMapping(value - "/getxml", produces= 
{"application/xml; charset=UTF-8"})//4 
public DemoObj getxml(DemoObj obj){ 


return new DemoObj(obj.getId()-*1, obj.getName()+"yy") 


代码 解释 


(D 使 用 @RestController， 声 明 是 控制 器 ， 并 且 返 回 数 据 时 
不 需要 @ResponseBody。 


返回 数据 的 媒体 类 型 为 json。 

直接 返回 对 象 ， 对 象 会 自动 转换 成 json。 
由 返回 数据 的 媒体 类 型 为 xml。 

吕 直 接 返 回 对 象 ， 对 象 会 自动 转换 为 xml。 
结果 如 图 4-4 和 图 4-5 所 示 。 


€ c localhost:8080/highlight springmvc4/rest/getjson?id- 1&name-x 








name: "xxyy 











图 4-4 访问 http://localhost: 8080/highlight springmvc4/rest/getjson ? 
id=1&name=xx 





e localhost:8080/highlight springmvc4/rest/getxml?id- 1&name-xx 


This XML file does not appear to have any style information associated with it. 
document tree is shown below. 
v 4DemoObj xmlns-""» 


<name>xxyy</name> 
</DemoObj > 











图 4-5 访问 http://localhost: 8080/highlight springmvc4/rest/getxml ? 
id=1&name=xx 


4.4 Spring MVC 基 本 配置 


Spring MVC 的 定制 配置 需要 我 们 的 配置 类 继承 一 个 
WebMvcConfigurerAdapter 类 ， 并 在 此 类 使 用 @EnableWebMyvc 
注解 ， 来 开局 对 Spring ” MVC 的 配置 文 持 ， 这 样 我 们 就 可 以 重 
写 这 个 类 的 方法 ， 完 成 我 们 的 常用 配置 。 


我 们 将 前 面 的 MyMvcConfig 配 置 类 继承 
WebMvcConfigurerAdapter， 本 章 奉 不 做 特别 说 明 ， 则 关于 配 
置 的 相关 内 容 都 在 MyMvcConfig 里 编写 。 





4.4.1 BE GE UR IUS 


1.5 Hi 


程序 的 静态 文件 (js、css、 图 片 ) 等 需要 直接 访问 ， 这 时 
我 们 可 以 在 配置 里 重 写 addResourceHandlers 方 法 来 实现 。 


2. 示 例 
(1) 添加 静态 资源 


同上 上， 我们 在 srwmain/resources 下 建立 assets/js 目 录 ， 并 复 
制 一 个 jquery.js 放 置 在 此 目录 下 ， 如 图 4-6 所 示 。 











15 src/main/resources 


wv (> assets 


vá (=> js 


jquery.js 
v © views 
index.jsp 
图 4-6 ”复制 一 个 jquery.js 放 置 在 assetsljs 目 录 下 
配置 代码 : 





package com.wisely.highlight_springmvc4; 


import 
import 
import 
import 
import 
import 
import 
import 


org. 
org. 
org. 
org. 
org. 
org. 
org. 
org. 


springframework. 
springframework. 
springframework. 
springframework. 
springframework. 
springframework. 
springframework. 
springframework. 


@Configuration 
@EnablewebMvc//1 
@ComponentScan("com.wisely.highlight_springmvc4" ) 

public class MyMvcConfig extends WebMvcConfigurerAdapter{//2 


@Bean 
public InternalResourceViewResolver viewResolver(){ 
InternalResourceViewResolver viewResolver = 

new InternalResourceViewResolver(); 
viewResolver.setPrefix("/WEB-INF/classes/views/"); 
viewResolver.setSuffix(".jsp"); 
viewResolver.setViewClass(JstlView.class); 

return viewResolver; 


context.annotation.Bean; 
context.annotation.ComponentScan; 
context.annotation.Configuration; 
web.servlet.config.annotation.Enab 
web.servlet.config.annotation.Reso 
web.servlet.config.annotation.WebM 
web.servlet.view.InternalResourceV 
web.servlet.view.JstlView; 


@Override 
public void addResourceHandlers(ResourceHandlerRegistry r 


registry.addResourceHandler("/assets/**").addResource 


代码 解释 


(CO@EnableWebMvc 开 启 SpringMVC 支 持 ， 若 无 此 句 ， 重 写 
WebMvcConfigurerAdapter 方 法 无 效 。 





@ 继 承 WebMvcConfigurerAdapter 类 ， 重 写 其 方法 可 对 
Spring MVC 进 行 配置 。 


G@)addResourceLocations 指 的 是 文件 放置 的 目录 ， 
addResourceHandlerfi H5] zy /h 2$ $E B5 97 In] Eg £4 o 








44.2 ”拦截 器 配置 


1. 点 睛 


kas (Interceptor) 实现 对 每 一 个 请 求 处 理 前 后 进行 相关 
的 业务 处 理 ， 类 似 于 Servlet 的 Filter。 


可 让 普通 的 Bean 实 现 HanlderInterceptor 接 口 或 者 继承 
HandlerInterceptorAdapter 类 来 实现 自 定 义 拦 截 器 。 








通过 重 写 WebMvcConfigurerAdapter 的 addInterceptors 方 法 
来 注册 自 定义 的 拦截 器 ， 本 市 演示 一 个 简单 的 拦截 器 的 开发 和 
配置 ， 业 务 含义 为 计算 每 一 次 请 求 的 处 理 时 间 。 











2. 示 例 
(1) 示例 拦截 器 。 


package com.wisely.highlight_springmvc4.interceptor; 


import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 


import org.springframework.web.servlet.ModelAndView; 
import org.springframework.web.servlet.handler.HandlerInt 


public class DemoInterceptor extends HandlerInterceptorAd 


QOverride 
public boolean preHandle(HttpServletRequest request, 
HttpServletResponse response, Object handler) 
long startTime = System.currentTimeMillis(); 
request.setAttribute("startTime", startTime); 
return true; 


j 


QOverride 
public void postHandle(HttpServletRequest request, // 
HttpServletResponse response, Object handler, 
ModelAndView modelAndView) throws Exception { 
long startTime - (Long) request.getAttribute("sta 
request.removeAttribute("startTime"); 
long endTime - System.currentTimeMillis(); 


erce 


apte 


//2 
thr 


3 


rtTi 




















System,out,println(" 本 次 请 求 处 至 
为 :" + new Long(endTime - startTime)+"ms"); 
request.setAttribute("handlingTime", endTime - st 
} 


代码 解释 











时 间 


artT 


QD 继承 HandlerInterceptorAdapter 类 来 实现 自 定义 拦截 器 。 


@ 重 写 preHandle 方 法 ， 在 请 求 发 生前 执行 。 





@ 重 写 postHandle 方 法 ， 在 请 求 完 成 后 执行 。 
(2) 配置 。 


@Bean //1 

public DemoInterceptor demoInterceptor(){ 
return new DemoInterceptor(); 

} 


QOverride 
public void addInterceptors(InterceptorRegistry registry) 
registry.addInterceptor(demoInterceptor()); 


代码 解释 
GD 配 置 拦截 器 的 Bean。 
@) 重 写 addInterceptors 方 法 ， 注 册 拦 截 器 。 


(3) 运行。 在 浏览 器 访问 任意 路 径 ， 如 http:/Wlocalhost: 
8080/highlight_springmvc4/index， 查 看 控制 台 如 图 4-7 所 示 。 


: 15:07:44.482 o.s.web.servlet.Disp 
: 15:07:44.485 0.5.w.s.m.m.a.Reques 
: 15:07:44.487 .W.S.m.m.a.Reques 
: 15:07:44.488 o.s.web.servlet.Disp 


本 次 请 求 处 理 时 间 为 : 12ms 


logbak: 15:07:44.503 o.s.web.servlet.Disp 
logbak: 15:07:44.506 o.s.web.servlet.vie 
logbak: 15:07:44.516 o.s.web.servlet.Disp 





图 4-7 ”控制 台 


4.4.3 @ControllerAdvice 


1. 点 睛 


通过 @ControllerAdvice， 我 们 可 以 将 对 于 控制 右 的 全 局 配 
置 放置 在 同一 个 位 置 ， 注 解 了 @Controller 的 类 的 方法 可 使 用 
(@ExceptionHandler、@InitBinder、@ModelAttribute 注 解 到 方 
法 上 ， 这 对 所 有 注解 了 @RequestMapping 的 控制 器 内 的 方法 有 
效 。 


@ExceptionHandler: 用 于 全 局 处 理 控制 器 里 的 异常 。 


@InitBinder: 用 来 设置 WebDataBinder，WebDataBinder 用 
来 自动 绑 定 前 人 台 请 求 参数 到 Model 中 。 


@ModelAttribute: @ModelAttribute 本 来 的 作用 是 绑 定 键 值 
对 到 Model 里 ， 此 处 是 让 全 局 的 @RequestMapping 都 能 获得 在 
此 处 设置 的 键 值 对 。 


本 节 将 演示 使 用 @ExceptionHandler 处 理 全 局 异常 ， 更 人 性 
化 的 将 异常 输出 给 用 户 。 


2. 示 例 





(1) 定制 ControllerAdvice。 


package com.wisely.highlight_springmvc4.advice; 


import org.springframework.ui.Model; 

import org.springframework.web.bind.WebDataBinder ; 

import org.springframework.web.bind.annotation.ControllerAdvi 
import org.springframework.web.bind.annotation.ExceptionHandl 
import org.springframework.web.bind.annotation.InitBinder; 
import org.springframework.web.bind.annotation.ModelAttribute 
import org.springframework.web.context.request.WebRequest; 


import org.springframework.web.servlet.ModelAndView; 


@ControllerAdvice //1 
public class ExceptionHandlerAdvice { 


@ExceptionHandler(value = Exception.class) //2 
public ModelAndView exception(Exception exception, WebReq 
ModelAndView modelAndView = new ModelAndView("error") 


xs 
El 


modelAndView.addObject("errorMessage", exception.getM 
return modelAndView; 


} 
@ModelAttribute //3 


public void addAttributes(Model model) { 
model.addAttribute("msg", "额外 信息 "); //3 


@InitBinder //4 

public void initBinder(WebDataBinder webDataBinder) { 
webDataBinder.setDisallowedFields("id"); //5 

} 


代码 解释 
(D@ControllerAdvice 声 明 一 个 控制 右 建 言 ， 


@ControllerAdvice 组 合 了 @Component 注 解 ， 所 以 自动 注册 为 
Spring 的 Bean。 


(OD@ExceptionHandler 在 此 处 定义 全 局 处 理 ， 通 过 


(@ExceptionHandler 的 value 属 性 可 过 小 拦截 的 条 件 ， 在 此 处 我 
们 可 以 看 出 我 们 拦截 所 有 的 Exception。 


人 此 处 使 用 @ModelAttribute 注 解 将 键 值 对 添加 到 全 局 ， 上 所 


有 注解 的 @RequestMapping 的 方法 可 获得 此 键 值 对 。 


(43H x @ InitBinder?E f# 4E Hill WebDataBinder. 


©) HC A TRI 示 忽 略 request 参 数 的 d， 更 多 关于 WebDataBinder 
的 配置 ， 请 请 参考 WebDataBinder 的 API 文 档 。 





(2) TRANS Hill as 


package com.wisely.highlight_springmvc4.web.ch4_4; 


import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.ModelAttribute 
import org.springframework.web.bind.annotation.RequestMapping 


import com.wisely.highlight springmvc4.domain.DemoObj; 


@Controller 
public class AdviceController { 

@RequestMapping("/advice" ) 

public String getSomething(@ModelAttribute("msg") String 
{//1 


throw new IllegalArgumentException("dE25183A, BAA 
ix/"-"3kBEgModelAttribute:"- msg); 














(3) AES EZ I» 


在 Src/main/resources/views 下 ， 新 建 error.jsp， 内 容 如 下 : 


«9 taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" 
<%@ page language="java" contentType="text/html; charset=UTF - 


8" 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "- 
//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/ 
<html> 
<head> 
<meta http-equiv-"Content- 


Type" content="text/html; charset=UTF-8"> 
<title>@ControllerAdvice Demo</title> 


</head> 

<body> 
${errorMessage} 

</body> 

</html> 


(4) 运行 。 
访问 http://localhost: 8080/highlight springmvc4/advice? 


id-1&name-xx. 


调试 查看 DemoObj，id 被 过 滤 择 了 ， 且 获得 了 
@ModelAttribute 的 msg 信 息 ， 如 图 4-8 所 示 。 























v 9 msg [ "MBE" (id-75) 
m hash 0 
a value (id- 93) 

v 9 obj DemoObj (id-80) 
a id null 
B name "xx" (id=91) 











图 4-8 ”页面 效果 
页 面 效 果 如 图 4-9 所 示 。 





O @ControllerAdvice x 
V C | [3localhost:8080/highlight springmvc4/advice?id- 1&name-xx 
非常 抱歉 ， 参 数 有 误 / 来 自 @odelAttribute: 额 外 信息 . 


图 4-9 页 面 效果 








4.4.4 其 他 配置 


1. 快 捷 的 ViewController 
在 4.2.2 节 我 们 配置 页 面 转 同 的 时 候 使 用 的 代码 如 下 : 


@RequestMapping("/index")//2 
public String hello(){ 
return "index"; //3 





此 处 无 任何 业务 处 理 ， 只 是 简单 的 页 面 转 问 ， 写 了 至 少 三 
行 有 效 代码 ， 在 实际 开发 中 会 涉及 大 量 这 样 的 页 面 转 同 ， 帮 部 
这 样 写 会 很 腑 烦 ， 我 们 可 以 通过 在 配置 中 重 写 
addViewControllers 来 简化 配置 : 





QOverride 
public void addViewControllers(ViewControllerRegistry reg 
registry.addViewController("/index").setViewName("/in 


这 样 实现 的 代码 更 简洁 ， 管 理 更 集中 。 

2. 路 径 匹 配 参数 配置 

在 Spring ” MVC 中 ， 路 径 参 数 如 果 市 “.” 的 话 ,“.” 后 面 的 值 
将 被 忽略 ， 例 如 ， 访 问 http://localhost: 


8080/highlight_springmvc4/anno/pathvar/xx.yy， 此 时 “.” 后 面 的 
yy 被 忽略 ， 如 图 4-10 所 示 。 





€ c localhost:8080/highlight springmvc4/anno/pathva 


url:http: // localhost: 8080/highlight springmvcá/anno/pathvar/xx. yy can access, stri XX 








图 4-10 忽略 “.” 后 面 的 yy 


通过 重 写 configurePathMatch 方 法 可 不 忽略 “.” 后 面 的 参数 ， 
代码 如 下 : 


@Override 


public void configurePathMatch(PathMatchConfigurer config 
configurer.setUseSuffixPatternMatch( false); 


j 


这 时 再 访问 http://localhost: 
8080/highlight_springmvc4/anno/pathvar/xXx.yy， 就 可 以 接 
受 “.” 后 面 的 yy 了， 如 图 4-11 所 示 。 


€ Q | D localhost:8080/highlight springmvc4/anno/pathvar/xx.y 





url:http: //localhost: 8080/highlight springmvcá/anno/pathvar/xx. yy can access, str: xx. yy 




















图 4-11 接受 “.” 后 面 yy 
3. 更 多 配置 


更 多 配置 请 查看 WebMvcConfigurerAdapter 类 的 API。 因 其 
是 WebMvcConfigurer 接 口 的 实现 ， 所 以 WebMvcConfigurer 的 
API 内 的 方法 也 可 以 用 来 配置 MVC。 下 面 我 们 列 出 了 
WebMvcConfigurerAdapter 和 WebMvcConfigurer 的 源码 。 








4.WebMvcConfigurerAdapter 


public abstract class WebMvcConfigurerAdapter implements WebM 
QOverride 
public void addFormatters(FormatterRegistry registry) { 


QOverride 
public void configureMessageConverters(List«HttpMessageCo 
>> converters) { 


@Override 
public void extendMessageConverters(List<HttpMessageConve 
>> converters) { 


@Override 

public Validator getValidator() { 
return null; 

} 


@Override 
public void configureContentNegotiation(ContentNegotiatio 


QOverride 
public void configureAsyncSupport(AsyncSupportConfigurer 


QOverride 
public void configurePathMatch(PathMatchConfigurer config 


QOverride 
public void addArgumentResolvers(List«HandlerMethodArgume 


QOverride 
public void addReturnValueHandlers(List«HandlerMethodRetu 


QOverride 
public void configureHandlerExceptionResolvers(List«Handl 


QOverride 
public MessageCodesResolver getMessageCodesResolver() ( 
return null; 


@Override 
public void addInterceptors(InterceptorRegistry registry) 


@Override 
public void addViewControllers(ViewControllerRegistry reg 


QOverride 
public void configureViewResolvers(ViewResolverRegistry r 


QOverride 
public void addResourceHandlers(ResourceHandlerRegistry r 


QOverride 
public void configureDefaultServletHandling(DefaultServle 


j 


5. WebMvcConfigurer 


public interface WebMvcConfigurer { 


void addFormatters(FormatterRegistry registry); 

void configureMessageConverters(List<HttpMessageConverter 
>> converters); 

void extendMessageConverters(List<HttpMessageConverter<? 
>> converters); 

Validator getValidator(); 

void configureContentNegotiation(ContentNegotiationConfig 

void configureAsyncSupport(AsyncSupportConfigurer configu 

void configurePathMatch(PathMatchConfigurer configurer); 

void addArgumentResolvers(List«HandlerMethodArgumentResol 


void addReturnValueHandlers(List«HandlerMethodReturnValue 
void configureHandlerExceptionResolvers(List«HandlerExcep 
void addInterceptors(InterceptorRegistry registry); 
MessageCodesResolver getMessageCodesResolver(); 

void addViewControllers(ViewControllerRegistry registry); 
void configureViewResolvers(ViewResolverRegistry registry 
void addResourceHandlers(ResourceHandlerRegistry registry 
void configureDefaultServletHandling(DefaultServletHandle 


4.5 Spring MVC 的 高 级 配置 
4.5.1 文件 上 传 配 置 


ed 


文件 上 传 是 一 个 项 目 里 经 常 要 用 的 功能 ，Spring MVC 通 过 
配置 一 个 MultipartResolver 来 上 传 文件 。 


在 Spring 的 控制 器 中 ， 通 过 MultipartFile file 来 接收 文件 ， 
通过 MultipartFile[]files 接 收 多 个 文件 上 传 。 


2. 示 例 
C1) 添加 文件 上 传 依赖 。 





<!-- file upload --> 

<dependency> 
<groupId>commons - fileupload</groupId> 
<artifactId>commons-fileupload</artifactId> 
<version>1.3.1</version> 


</dependency> 
<!-- 非 必 需 ， 可 简化 I/0 操 作 - -> 
<dependency> 


<groupId>commons-io</groupId> 

<artifactId>commons-io</artifactId> 

<version>2.3</version> 
</dependency> 


(2) 上 传 页 面 。 在 src/main/resources/views 下 新 建 
upload.jsp。 


<%@ page language="java" contentType="text/html; charset=UTF - 
gu 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "- 
//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/ 
<html> 
<head> 
<meta http-equiv="Content - 
Type" content="text/html; charset=UTF-8"> 
<title>upload page</title> 


</head> 
<body> 


<div class="upload"> 
«form action="upload" enctype="multipart/form- 
data" method="post"> 
<input type="file" name="file"/><br/> 
«input type="submit" value=" 上传 "> 
</form> 
</div> 


</body> 
</html> 


(3) 添加 转向 到 upload 页 面 的 ViewController。 


@Override 

public void addViewControllers(ViewControllerRegistry reg 
registry.addViewController("/index").setViewName("/in 
registry.addViewController("/toUpload").setViewName(" 


(4) MultipartResolverfit & . 


QBean 
public MultipartResolver multipartResolver() { 


CommonsMultipartResolver multipartResolver = 
new CommonsMultipartResolver(); 

multipartResolver .setMaxUploadSize(1000000) ; 

return multipartResolver; 


(5) 控制 器 。 


package com.wisely.highlight_springmvc4.web.ch4_5; 


import java.io.File; 
import java.io.IOException; 


import org.apache.commons.io.FileUtils; 

import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.ResponseBody; 
import org.springframework.web.multipart.MultipartFile; 


@Controller 
public class UploadController { 


@RequestMapping(value = "/upload",method = RequestMethod. 
public @ResponseBody String upload(MultipartFile file) {/ 


try { 
FileUtils.writeByteArrayToFile(new File("e:/u 


file.getBytes()); //2 
return "ok"; 
) catch (IOException e) { 
e.printStackTrace(); 
return "wrong"; 


代码 解释 


ft H MultipartFile file 接 受 上 传 的 文件 。 
Qt FH FileUtils.writeByteArray ToFileTA5 55 xc fF] fd 34 


(6) 运行。 访问 http:/localhost: 
8080/highlight_springmvc4/toUpload， 如 图 4-12 所 示 。 














@ upload page x 
€ C | D localhost:8080/highlight springmvc4/toUpload 
| 选择 文件 log. txt 
| Ete 
图 4-12 访问 


单 击 “ 上 传 ” 按 钮 后 ， 查 看 e: \upload 文 件 夹 ， 如 图 4-13 所 


电脑 《> 本 地 磁盘 (E:) > upload 


A 


log.txt 





图 4-13 ”查看 upload 文 件 夹 
45.2 Exe X HttpMessageConverter 


1. B 


HttpMessageConverter ze H R Ab Sl request #llresponse Ei Rf] Zi 
据 的 。Spring 为 我 们 内 置 了 大 量 的 HttpMessageConverter， 例 


Qi, MappingJackson2HttpMessageConverter, 

StringHttpMessage Converter 等 。 本 节 将 演示 自 定 义 的 
HttpMessageConverter， 并 注册 这 个 HttpMessageConverter 到 
Spring MVC. 


2. 示 例 


(1) 自 定 义 HttpMessageConverter。 


package com.wisely.highlight_springmvc4.messageconverter; 


import java.io.IOException; 
import java.nio.charset.Charset; 


import org.springframework.http.HttpInputMessage; 

import org.springframework.http.HttpOutputMessage; 

import org.springframework.http.MediaType; 

import org.springframework.http.converter.AbstractHttpMessage 
import org.springframework.http.converter.HttpMessageNotReada 
import org.springframework.http.converter.HttpMessageNotWrita 
import org.springframework.util.StreamUtils; 


import com.wisely.highlight springmvc4.domain.DemoObj; 
public class MyMessageConverter extends AbstractHttpMessageCo 


public MyMessageConverter() ( 


super(new MediaType("application", "X- 
wisely",Charset.forName("UTF-8")));//2 
} 
/** 
* 3 
*/ 
@Override 


protected DemoObj readInternal(Class«? extends DemoObj» c 
HttpInputMessage inputMessage) throws IOException 
HttpMessageNotReadableException { 

String temp - StreamUtils.copyToString(inputMessage.g 


Charset.forName("UTF-8")); 
String[] tempArr - temp.split("-"); 


return new DemoObj(new Long(tempArr[0]), tempArr[1]); 


QOverride 
protected boolean supports(Class<?> clazz) { 
return DemoObj.class.isAssignableFrom(clazz); 


QOverride 
protected void writeInternal(DemoObj obj, HttpOutputMessa 
throws IOException, HttpMessageNotWritableExcepti 
String out = "hello:" + obj.getId() + "-" 
+ obj.getName( ); 
outputMessage.getBody( ).write(out.getBytes()); 
} 


代码 解释 


(继承 AbstractHttpMessageConverter 接 口 来 实现 目 定 义 的 
HttpMessageConverter. 


地 新 建 一 个 我 们 上 自 定 义 的 媒体 类 型 application/x-wisely。 


G@) 重 写 readIntenal 方 法 ， 处 理 请 求 的 数据 。 代 码 表 明 我 们 
处 理由 “-” 隔 开 的 数据 ， 并 转 成 DemoObj 的 对 象 。 


(表明 本 HttpMessageConverter 只 处 理 DemoObj 这 个 类 。 


@@) 重 写 writeInternal， 处 理 如 何 输出 数据 到 response。 此 例 
中 ， 我 们 在 原样 输出 前 面 加 上 “hello: ”。 


(2) 配置 。 在 addViewControllers 中 添加 viewController 映 











财 页 面 访问 演示 页 面 ， 代 码 如 下 : 


registry.addViewController("/converter").setViewName("/conver 


配置 自 定 义 的 HttpMessageConverter 的 Bean， 在 Spring 
MVC 里 注册 HttpMessageConverter 有 两 个 方法 : 


。 configureMessageConverters: 重 载 会 覆盖 抒 Spring MVCZA 
认 注 册 的 多 个 HttpMessageConverter。 

e extendMessageConverters: 仅 添 加 一 个 自 定义 的 
HttpMessageConverter， 不 履 盖 默认 注册 的 
HttpMessageConverter。 


所 以 在 此 例 中 我 们 重 写 extendMessageConverters: 


@Override 
public void extendMessageConverters(List<HttpMessageConve 
>> converters) { 
converters.add(converter()); 
} 


@Bean 

public MyMessageConverter converter(){ 
return new MyMessageConverter(); 

} 


(3) TRAN LE Till ae o 


package com.wisely.highlight_springmvc4.web.ch4_5; 


import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.RequestBody; 
import org.springframework.web.bind.annotation.RequestMapping 


import org.springframework.web.bind.annotation.ResponseBody; 
import com.wisely.highlight springmvc4.domain.DemoObj; 


@Controller 
public class ConverterController { 


@RequestMapping(value = "/convert", produces = { "applica 
wisely" }) //1 
public @ResponseBody DemoObj convert(@RequestBody DemoObj 


return demoObj; 


代码 解释 
指定 返回 的 媒体 类 型 为 我 们 目 定 义 的 媒体 类 型 


application/x-wisely. 


(4) 演示 页 面 。 在 src/main/resources 下 新 建 conventer.jsp: 


<%@ page language="java" contentType="text/html; charset-UTF- 


8" 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "- 
//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/ 
<html> 
<head> 
<meta http-equiv-"Content- 


Type" content="text/html; charset=UTF-8"> 
<title>HttpMessageConverter Demo</title> 


</head> 
<body> 

<div id="resp"></div> 
«input type="button" onclick="req();" value=" 请 求 "/> 
<script src="assets/js/jquery.js" type="text/javascript"> 
</script> 
<script> 


function req(){ 


$.ajax({ 
url: "convert", 
data: "1-wangyunfei", //1 
type: "POST", 
contentType:"application/x-wisely", //2 
success: function(data) { 
$("#resp").html(data); 


1): 
j 


«/script» 
«/body» 
</html> 


代码 解释 


注意 这 里 的 数据 格式 ， 后 合 处 理 按 此 格式 处 理 ， 
He 


C)contentType 设 置 的 媒体 类 型 是 我 们 目 定 义 的 
application/x-wisely . 


(5) 运行。 访问 http:/localhost: 
8080/highlight_springmvc4/converter， 如 图 4-14 所 示 。 





HttpMessageConv: x 
€ © localhost lighlight_springmvc4/converter 





请 求 





用 € » bs 
x 


图 4-14 访问 http://localhost: 8080/highlight springmvc4/converter 





单 击 “ 请 求 ” 按 钮 ， 做 如 下 观察 。 


请 求 类 型 如 图 4-15 所 示 。 





Name X | Headers | Preview Response Cookies Timing 


|_| converter Y General 

Remote Address: [::1]:8080 

Request URL: http://localhost:8080/highlight springmvc4/convert 
Request Method: POST 

Status Code: @ 202 OK 








Content-Type: application/x-wisely 





Date: Sun, 14 Jun 2015 07:05:25 GMT 
Server: Apache-Coyote/1.1 
Transfer-Encoding: chunked 

Y Request Headers view source 
Accept: */* 
Accept-Encoding: gzip, deflate 
Accept-Language: zh-CN, zh;q=0.8 
Connection: keep-alive 






onten pe: application/x-wise 
Cookie: J5ESSIONID-8A0E5669EF7E3E7303A9EEC25F626DA2 

Host: localhost:8080 

Origin: http://localhost:8080 

Referer: http://localhost:8080/highlight springmvc4/converter 
User-Agent: Mozilla/5.@ (Windows NT 10.0; WOW64) AppleWebKit/53 
X-Requested-With: XMLHttpRequest 


112 : 1-wangyunfei 
图 4-15 ”请 求 类 型 


后 台 获 得 我 们 目 定 义 的 数据 格式 ， 如 图 4-16 所 示 。 




















Name Value 
© this ConverterController (id=122) 
r © demoObj DemoObj (id=123) 
a id Long (id=132) 
a name "wangyunfei" (id- 136) 











图 4-16 Ae XUI REX 
页 面 效 果 如 图 4-17 所 示 。 


€ C | D localhost:8080/highlight springmvc4/converter 





hello:l-wangyunfei 


请 求 





图 4-17 页面 效果 


4.5.3. ”服务 器 端 推 送 技术 





HRA 3m FETS SC YE BUT] AT BOA HI, n] 


ANE Zee ED Ajax lal ARS s de WE, EA bas SY 
Bé eb — I TRI SR f ARS i AYE e AAPEA SU E RECS AN E 
f. HAKKE Y BRA. 


本 节 所 有 的 服务 器 端 推送 的 方案 都 是 基于 : 当 客 户 端 向 服 
务 端 发 送 请 求 ， 服 务 端 会 抓 住 这 个 请 求 不 放 ， 等 有 数据 更 新 的 
时 候 才 返回 给 客户 端 ， 当 客户 端 接收 到 消息 后 ， 再 向 服务 端 发 
送 请 求 ， 周 而 复 始 。 这 种 方式 的 好 处 是 减少 了 服务 器 的 请 求 数 
量 ， 大 大 减少 了 服务 器 的 压力 。 

除了 服务 器 端 推 送 技术 以 外 ， 还 有 一 个 另外 的 双向 通信 的 
技术 一 一 WebSocket， 我 们 将 在 本 书 第 三 部 分 实战 Spring Boot 
中 演示 。 


本 节 将 提供 基于 SSE (Server Send Event 服 务 端 发 送 事件 ) 
的 服务 器 端 推送 和 基于 Servlet 3.0+ 的 异步 方法 特性 ， 其 中 第 一 
种 方式 需要 新 式 浏 览 右 的 文 持 ， 第 二 种 方式 是 路 浏览 右 的 。 


1.SSE 
C1) dBo T fil o 


























package com.wisely.highlight springmvc4.web.ch4 5; 
import java.util.Random; 


import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.ResponseBody; 


@Controller 
public class SseController { 


@RequestMapping(value="/push", produces="text/event - 
stream") //1 
public @ResponseBody String push(){ 
Random r = new Random(); 
try { 


Thread.sleep(5000); 
) catch (InterruptedException e) ( 
e.printStackTrace(); 


} 
return "data:Testing 1,2,3" + r.nextInt() +"\n\n"; 
} 
} 
代码 解释 


QD 注意 ， 这 里 使 用 输出 的 媒体 类 型 为 text/event-stream， 这 


征服 务 器 端 SSE 的 文 持 ， 本 例 演 示 每 5 秒 钟 癌 浏 览 右 推送 随机 
消息 。 


(2) 演示 页 面 。 在 src/main/resources/views 下 新 建 sse.jsp: 


«99 taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" 
<%@ page language="java" contentType="text/html; charset-UTF- 
g" 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "- 
//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/ 
«html» 
<head> 
<meta http-equiv="Content - 
Type" content="text/html; charset=UTF-8"> 
<title>SSE Demo</title> 


</head> 
<body> 


<div id="msgFrompPush"></div> 

<script type="text/javascript" src=" 
<c:url value="assets/js/jquery.js" />"></script> 

<script type="text/javascript"> 


if (!!window.EventSource) { //1 
var source = new EventSource('push'); 


sats 

source.addEventListener('message', 
st=e.datat"<br/>"; 
$("4msgFrompPush").html(s); 


J): 


source.addEventListener('open', function(e) ( 


console.log( EHdJJf."); 
}, false); 





source.addEventListener('error', function(e) { 
if (e.readyState == EventSource.CLOSED) { 


console.log( 3XEBEXB"); 
) else { 
console.log(e.readyState); 





} 
}, false); 
) else ( 


console.1og(" 你 的 浏览 器 不 文 持 SSE" ) ; 


</script> 
</body> 
</html> 


代码 解释 


{//2 


(DEventSource 对 象 只 4 有 新 式 的 浏 Lx 7 有 (Chrome, 


Firefox) 等 ，EventSource 是 SSE 的 客户 端 


QUSIUSSES PF vig tT, CELE IRA ds Pm EIS AY TH Je e 


(3) BUE. 
添加 转向 sse.jsp 页 面 的 映射 : 


registry.addViewController("/sse").setViewName("/sse"); 


(4) 运行 。 访 问 http://localhost: 
8080/highlight_springmvc4/sse， 如 图 4-18 所 示 。 

















€ C | D localhost8080/highlight springmvc4/sse 

Testing 1, 2, 3963088277 

Testing 1, 2, 3-171060687 

Testing 1, 2, 3-1406895476 

Testing 1, 2, 3-1934411557 

Testing 1, 2, 3-1446959901 

Testing 1, 2, 3-1934192666 
sse 200 document 

jque 304 
push 200 text/event-stream 
push 200 nt-stream 
push 200 ext/event-stream 

ush fpendmg] ] 











图 4-18 ”运行 效果 
2.Servlet 3.0+ 异 步 方法 处 理 
OD 开启 异步 方法 支持 : 





Dynamic servlet = servletContext.addServlet("dispatcher", 
servlet.addMapping("/"); 
servlet.setLoadOnStartup(1); 
servlet.setAsyncSupported(true);//1 


代码 解释 
(此 句 开局 异步 方法 文 持 。 
(2) 演示 控制 器 : 








package com.wisely.highlight_springmvc4.web.ch4_5; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.RequestMapping 


import org.springframework.web.bind.annotation.ResponseBody; 
import org.springframework.web.context.request.async.Deferred 


import com.wisely.highlight_springmvc4.service.PushService; 


@Controller 

public class AysncController { 
@Autowired 
PushService pushService; //1 


@RequestMapping("/defer" ) 

@ResponseBody 

public DeferredResult<String> deferredCall() { //2 
return pushService.getAsyncUpdate( ); 

} 


代码 解释 


异步 任务 的 实现 是 通过 控制 妖 从 另外 一 个 线程 返回 一 个 
DeferredResult， 这 里 的 DeferredResult 是 从 pushService 中 获得 
的 。 





(QD) 定时 任务 ， 定 时 更 新 DeferredResult。 
Qik [n] A 2€ F vii DeferredResult. 
(3) 定时 任务 : 


package com.wisely.highlight_springmvc4.service; 


import org.springframework.scheduling.annotation.Scheduled; 
import org.springframework.stereotype.Service; 
import org.springframework.web.context.request.async.Deferred 


@Service 
public class PushService { 
private DeferredResult<String> deferredResult; //1 


public DeferredResult<String> getAsyncUpdate() {//1 
deferredResult = new DeferredResult<String>(); 
return deferredResult; 


j 


QScheduled(fixedDelay - 5000) 
public void refresh() (//1 
if (deferredResult !- null) ( 
deferredResult.setResult(new Long(System.currentT 
.toString()); 


代码 解释 


(在 PushService 里 产生 DeferredResult 给 控制 器 使 用 ， 通 过 
@Scheduled 注 解 的 方法 定时 更 新 DeferredResult。 


(4) 演示 页 面 


在 Srcmain/resources/views 下 新 建 async.jsp: 


<%@ page language="java" contentType="text/html; charset-UTF- 


8g" 

pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "- 
//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/ 
«html» 
«head» 
«meta http-equiv-"Content- 


Type" content="text/html; charset=UTF-8"> 
<title>servlet async support</title> 


</head> 

<body> 

<script type="text/javascript" src="assets/js/jquery.js"> 
</script> 

<script type="text/javascript"> 


deferred();//1 
function deferred(){ 
$.get('defer', function(data) { 
console.log(data); //2 
deferred(); //3 
3); 


«/script» 
</body> 
</html> 


代码 解释 


此 处 的 代码 使 用 的 是 jQuery 的 Ajax 请 求 ， 所 以 没有 浏览 器 
兼容 性 问题 。 


QD 页 面 打开 就 向 后 台 发 送 请 求 。 

@ 在 控制 台 输 出 服务 端 推送 的 数据 。 
一 次 请 求 完成 后 再 向 后 台 发 送 请 求 。 
(5) 配置 。 


在 MyMvcConfig 上 开始 计划 任务 的 支持 ， 使 用 
@EnableScheduling: 





@Configuration 

QEnablewebMvc 

QEnableScheduling 
@ComponentScan("com.wisely.highlight_springmvc4" ) 

public class MyMvcConfig extends WebMvcConfigurerAdapter { 


J 


添加 viewController: 


registry.addViewController("/async").setViewName("/async"); 


(6) 运行。 访问 http:/localhost: 
8080/highlight_springmvc4/async， 如 图 4-19 所 示 。 














Name Status Type Initiator Size Time 
|_| async 200 docum... Other 8048 73ms 
| |_| jquery.js 304 script asyne:13 938 20 ms 
|_| defer 200 xhr jquery,js:7829 161B 3.87 s 
jJ |_| defer 200 xhr query,js:7829 161B 498s 
|_| defer 200 xhr query.js:7829 161B 5,00 s 
jJ | | defer 200 xhr query.is:7829 161B 5.01 s 
| defer (pending) xhr jquery.js:7829 0B Pending 








图 4-19 运行 效果 


控制 台 输 出 如 图 4-20 所 示 。 











Qa 日 Elements Network Sources Timeline » > 2 o, x 
© Y <topframe> v Preserve log 
1434270922775 async :20 
1434270927777 async :28 
434270932778 async:20 
1434270937792 async:20 
1434270942794 async:20 
1434270947798 async:20 
1434270952801 async:20 
1434270957802 async:20 
1434270962805 async:20 
1434270967806 async:20 








图 4-20 ”控制 台 输 出 


4.6 Spring MVC 的 测试 
4.6.1 点睛 


测试 是 保证 软件 质量 的 关键 ， 所 以 我 们 在 “第 一 部 分 点 睛 
Spring 4.x”、“ 第 二 部 分 点 睛 Spring MVC 4.x” 和 “第 三 部 分 实战 
Spring Boot” 中 都 将 会 有 测试 相关 的 内 容 。 


在 第 一 部 分 ， 我 们 只 谈 了 简单 的 测试 。 在 本 节 ， 我 们 要 进 
行 一 些 和 Spring MVC 相 关 的 测试 ， 主 要 涉及 控制 器 的 测试 。 


为 了 测试 Web 项 目 通 冲 不 需要 局 动 项 目 ， 我 们 需要 一 些 
Servlet 相 关 的 模拟 对 象 ， 比 如 : MockMVC、 
MockHttpServletRequest. MockHttpServletResponse、 
MockHttpSession 等 。 























在 Spring 里 ， 我 们 使 用 @WebAppConfiguration 指 定 加 载 的 
ApplicationContext 是 一 个 WebApplicationContext。 


可 能 许多 人 ， 包 括 我 自己 以 前 也 党 得 测试 有 什么 用 ， 上 自己 
启动 一 下 ， 点 点 弄 弄 ， 就 像 我 们 前 面 的 例子 不 也 都 是 这 样 测 试 
的 吗 ? 其 实在 现实 开发 中 ， 我 们 是 先 有 需求 的 ， 也 就 是 说 先知 
道 我 们 想 要 的 是 什么 样 的 ， 然 后 按照 我 们 想 要 的 样子 去 开发 。 
在 这 里 我 也 要 引入 一 个 概念 叫 测试 驱动 开发 《Test Driven 
Development, TDD) ， 我 们 《设计 人 员 ) 按照 需求 先 写 一 个 
自己 预期 结果 的 测试 用 例 ， 这 个 测试 用 例 刚 开始 肯定 是 失败 的 
测试 ， 随 着 不 断 的 编码 和 重 构 ， 最 终 让 测试 用 例 通 过 测试 ， 这 
样 才能 保证 软件 的 质量 和 可 控 性 。 














在 下 面 的 示例 里 我 们 借助 JUnit 和 Spring TestContext 
framework， 分 别 演示 对 普通 页 面 转 问 形 控制 器 和 
RestController 进 行 测试 。 


4.6.2 ”示例 


(1) 测试 依赖 : 


<dependency> 
«groupId»org.springframework«/groupId» 
<artifactId>spring-test</artifactId> 
<version>${spring-framework.version}</version> 
<scope>test</scope> 
</dependency> 


<dependency> 
«groupId»junit«/groupId» 
<artifactId>junit</artifactId> 
<version>4.11</version> 
<scope>test</scope> 
</dependency> 


代码 解释 
这 里 <scope>test</scope> 说 明 这 些 包 的 存活 是 在 test 周 期 ， 
也 就 意味 着 发 布 时 我 们 将 不 包含 这 些 jar 包 。 


(2) 演示 服务 : 








package com.wisely.highlight_springmvc4.service; 
import org.springframework.stereotype.Service; 


@Service 
public class DemoService { 


public String saySomething(){ 
return "hello"; 


j 


(3) 测试 用 例 ， 在 src/test/java 下 : 


package com.wisely.highlight_springmvc4.web.ch4_6; 


import 
import 
import 
import 
import 
import 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


import 
import 


@RunWith(SpringJUnit4ClassRunner.class) 


static 
static 
static 
static 
static 
static 


org. 
org. 


org 


org. 
org. 


org 


springframework.test 


springframework.test. 
.springframework.test. 
springframework.test. 
springframework.test. 
.springframework.test 


org.junit.Before; 
org.junit.Test; 


org.junit.runner.RunWith; 
org.springframework. 


org.springframework.mock 
org.springframework.mock 


org.springframework.test. 
org.springframework.test. 


org.springframework.test 
org.springframework.test 


org.springframework. 


com.wisely.highlight springmvc4.MyMvcConfig; 


„web. 
web. 
web. 
web. 
web. 
„web. 


servlet. 


servlet 
servlet 
servlet 
servlet 


servlet. 


request .Mo 


.result. 
.result. 
.result. 
.result. 
result. 


Moc 
Moc 
Moc 
Moc 
Moc 


beans.factory.annotation.Autowired 
.web.MockHttpServletRequest; 

.web.MockHttpSession; 
org.springframework.test. 


context .ContextConfiguration; 
context. junit4.SpringJUnit4Cl 
context .web.wWebAppConfigurati 


.web.servlet .MockMvc; 
.web.servlet.setup.MockMvcBuil 
web.context.WebApplicationContext; 


com.wisely.highlight springmvc4.service.DemoService; 


QContextConfiguration(classes - 
QwebAppConfiguration("src/main/resources") //1 
public class TestControllerIntegrationTests { 


private MockMvc mockMvc; //2 


@Autowired 
private DemoService demoService;//3 


{MyMvcConfig.class}) 


@Autowired 
WebApplicationContext wac; //4 


@Autowired 
MockHttpSession session; //5 


@Autowired 
MockHttpServletRequest request; //6 


@Before //7 

public void setup() { 

this.mockMvc = 
MockMvcBuilders.webAppContextSetup(this.wac).bui 

} 


@Test 
public void testNormalController() throws Exception{ 
mockMvc.perform(get("/normal")) //8 
.andExpect(status().isOk())//9 
.andExpect(view().name("page"))//10 
.andExpect(forwardedUrl("/WEB- 
INF/classes/views/page.jsp"))//11 

.andExpect(model().attribute("msg", demoServi 


j 


QTest 
public void testRestController() throws Exception{ 
mockMvc.perform(get("/testRest")) //13 
.andExpect(status().isOk()) 
.andExpect(content().contentType("text/plain;charset 
8"))//14 
.andExpect(content().string(demoService.saySomething( 
} 


代码 解释 


(D@WebAppConfiguration 注 解 在 类 上 ， 用 来 声明 加 载 的 
ApplicationContex 是 一 个 WebApplicationContext。 它 的 属性 指 
定 的 是 web 资源 的 位 置 ， 默 认为 srcmain/webapp， 本 例 修 改 为 





src/main/resources o 


(DMockMvc- 模 拟 MVC 对 象 ， 通 过 
MockMvcBuilders.webAppContextSetup (this.wac) .build () 
初始 化 。 


@) 可 以 在 测试 用 例 中 注入 Spring 的 Bean。 

由 可 注入 WebApplicationContext。 

@ 可 注入 模拟 的 http session， 此 处 仅 作 演示 ， 没 有 使 用 。 
@@ 可 注入 模拟 的 http request， 此 处 仅 作 演示 ， 没 有 使 用 。 
(@D@Before 在 测试 开始 前 进行 的 初始 化 工作 。 

@ 模 拟 向 /normal 进 行 get 请 求 。 

9) 预期 控制 返回 状态 为 200。 

(0 预期 view 的 名 称 为 page。 


WD 预期 页 面 转向 的 真正 路 径 为 /WEB- 
INF/classes/views/page.jsp。 


(2 预期 model 里 的 值 是 demoService.saySomething () 返回 
值 hello。 


(3 模拟 问 /testRest 进 行 get 请 求 。 
多 预期 返回 值 的 媒体 类 型 为 text/plain; charset=UTF-8. 


(9 预期 返回 值 的 内 容 为 demoService.saySomething() 返回 
值 hello。 


此 时 运行 该 测试 效果 如 图 4-21 所 示 。 


gi JUnit 3 Q9 $9 oe SB| C, RS m E 
Finished after 1.087 seconds 


| Runs: 2/2 —— BErrors 0 B Failures: 2 


























n E 
v 国 com.wisely.highlight springmvc4.web.ch4 6.T = Failure Trace E| 
t] testRestController (0.075 s) 3 java.lang.AssertionError: Status expected:«20 ^ 





E] f 
Bk) testNormalController (0.006 s) at org.springframework.test.util.AssertionErr: 


at org.springframework.test.util.AssertionErr: 


at org.springframework.test.web.servlet.resu 


at org.springframework.test.web.servlet.Moc 








at com.wisely.highlight springmvc4.web.ch4 6.Tà 





at org.springframework.test.context.junit4.stz 
at org.springframework.test.context junit4.stz 
at org.springframework.test.context.junit4,ste 
at org.springframework.test.context.junit4.Sp 


at org.springframework.test.context.junit4.Sp 
v 
3 s E 1 uo 


^J MW n u m i 


> 











图 4-21 测试 效果 
(4) Sg E OBS P rl we 


package com.wisely.highlight springmvc4.web.ch4 6; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.stereotype.Controller; 

import org.springframework.ui.Model; 

import org.springframework.web.bind.annotation.RequestMapping 


import com.wisely.highlight springmvc4.service.DemoService; 


@Controller 

public class NormalController { 
@Autowired 
DemoService demoService; 


QRequestMapping("/normal") 

public String testPage(Model model) { 
model.addAttribute("msg", demoService.saySomething()) 
return "page"; 


(50 Sj Ey PE a ll SS AT aS DUT, TE 


iu Ge et 


<%@ page language="java" contentType="text/html; charset=UTF - 


gu 

pageEncoding="UTF-8"%> 
«IDOCTYPE html PUBLIC "- 
//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/ 
<html> 
<head> 
<meta http-equiv-"Content- 


Type" content="text/html; charset=UTF-8"> 
<title>Test page</title> 
</head> 
<body> 
<pre> 
Welcome to Spring MVC world 
</pre> 
</body> 
</html> 


(6) 4H RestControllerd2 fil] Z& 


package com.wisely.highlight_springmvc4.web.ch4_6; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.ResponseBody; 

import org.springframework.web.bind.annotation.RestController 


import com.wisely.highlight_springmvc4.service.DemoService; 


@RestController 
public class MyRestController { 


@Autowired 
DemoService demoService; 


@RequestMapping(value = "/testRest" ,produces="text/plain 
8") 
public @ResponseBody String testRest(){ 


return demoService.saySomething(); 


CD 运行 测试 ， 效 果 加 图 4-22 所 示 。 





& s Explorer gfu JUnit $3 m" 5E| & P H- = 6 
Finished after 1.112 seconds 


Runs: 2/2 BErors O Failures: OT 


> E com.wisely.highlight springmvc4.web.ch4 6.T = Failure Trace 3 

















< > 


图 4-22 ”测试 效果 





第 三 部 分 “实战 Spring Boot 


第 5 章 Spring Boot 基 础 


5.1 Spring Boot 概 述 
5.1.1 什么 是 Spring Boot 


随 着 动态 语言 的 流行 (Ruby. Groovy. Scala. 
Node.js) ，Java 的 开发 显得 格外 的 符 重 : 党 多 的 配置 、 低 下 的 
开 有 效率、 复杂 的 部 署 流程 以 及 第 三 方 技术 集成 难度 大 。 


在 上 述 环 境 下 ，Spring Boot 应 运 而 生 。 它 使 用 “习惯 优 于 配 
置 ”( 项 目 中 存在 大 量 的 配置 ， 此 外 还 内 置 一 个 习惯 性 的 配 
置 ， 让 你 无 须 手 动 进行 配置 ) 的 理念 让 你 的 项 目 快速 运行 起 
来 。 使 用 Spring Boot 很 容易 创建 一 个 独立 运行 (运行 jar， 内 髓 
Servlet 容 器 ，〉、 准 生产 级 别 的 基于 Spring 框 架 的 项 目 ， 使 用 
Spring Boot 你 可 以 不 用 或 者 只 需要 很 少 的 Spring 配 置 。 























5.1.2 Spring Boot 核 心 功能 


1. 独 立 运 行 的 Spring 项 目 





Spring Boot 可 以 以 jar 包 的 形式 独立 运行 ， 运 行 一 个 Spring 
Boot 项 目 只 需 通 过 java-jar xx.jar 来 运行 。 


2. A) tx Servlet7#. 4 


Spring Boot 可 选择 内 骸 Tomcat、Jetty 或 者 Undertow， 这 样 
我 们 无 须 以 war 包 形式 部 署 项 目 。 

3. 提 供 starter 人 简化 Maven 配 置 

Spring 提供 了 一 系列 的 starter ”pom 来 简化 Maven 的 依赖 加 


载 ， 例 如 ， 当 你 使 用 了 spring-boot-starter-web 时 ， 会 自动 加 入 
如 图 5-1 所 示 的 依赖 包 。 





图 5-1 自动 加 入 的 依赖 包 
4. 上 自动 配置 Spring 


Spring Boot 会 根据 在 类 路 径 中 的 jar 包 、 类 ， 为 jar 包 里 的 类 
自动 配置 Bean， 这 样 会 极 大 地 减少 我 们 要 使 用 的 配置 。 当 然 ， 
Spring ”Boot 只 是 考虑 了 大 多 数 的 开发 场景 ， 并 不 是 所 有 的 场 
景 ， 奋 在 实际 开发 中 我 们 需要 自动 配置 Beaan， 而 Spring Boot? 
有 提供 文 持 ， 则 可 以 自 定 义 自 动 配置 〈《 见 6.5 闻 ) 。 





5. 准 生产 的 应 用 监控 


Spring Boot 提 供 基 于 http、ssh、telnet 对 运行 时 的 项 目 进 行 
监控 《 见 第 10 章 ) 。 


6. 无 代码 生成 和 xml 配 置 

Spring _ Boot 的 神奇 的 不 是 借助 于 代码 生成 来 实现 的 ， 而 是 
通过 条 件 注解 来 实现 的 ， 这 是 Spring 4.x 提 供 的 新 特性 ， 在 3.5 
节 有 过 简单 的 演示 ， 本 章 将 用 大 量 的 篇 幅 讲 解 Spring Boot 实 现 
的 核心 技术 。 


Spring ”4.x 提倡 使 用 Java 配 置 和 注解 配置 组 合 ， 而 Spring 
Boot 不 需要 任何 xml 配 置 即 可 实现 Spring 的 所 有 配置 。 








5.1.3 Spring Boot 的 优 缺 点 


优 后 

(1) 快速 构建 项 目 ; 

(20 对 主流 开发 框 以 的 无 配置 集成 ; 

(30 项 目 可 独立 运行 ， 无须 外 部 依赖 Servlet 容 右 ; 


(4) 提供 运行 时 的 应 用 监控 ; 
(5) 极 大 地 提高 了 开发 、 部 普 效 率 ; 











(6) 与 云 计 算 的 天 然 集成 。 
Ut EA 








(1) 书籍 文档 较 少 且 不 够 深入 ， 这 是 直接 促使 我 写 这 本 
书 的 原因 ; 


(2) 如果 你 不 认同 Spring 框架 ， 这 也 许 是 它 的 缺点 ， 但 建 
议 你 一 定 要 使 用 Spring 框架 





5.1.4 ”关于 本 书 的 Spring Boot 版 本 


在 我 写 这 本 书 的 时 候 ，Spring Boot 的 最 新 正式 版 古 
1.2.4.RELEASE. Spring Boot 1.3.1.M2 里 程 碑 版 本 已 经 发 布 。 


Spring Boot 1.3.1.x 提 供 了 大 量 新 特性 ， 最 令 人 瞩目 的 是 还 
加 了 spring-boot-devtools 来 进行 开发 热 部 着， 本 书 将 以 Spring 
Boot 1.3.0 版 本 作为 演示 讲解 版 本 。 





5.2. Spring Boot 快 速 搭建 
5.2.1 http://start.spring.io 


(1) 打开 浏览 器 ， 在 地 址 栏 中 输入 http:/Wstart.spring.io， 如 
图 5-2 所 示 。 


Bootstrap your application now 


Project metadata Project dependencies 


Group Core Web 


Artifact 








图 5-2 打开 Spring.io 
(2) 填写 项 目 信 息 ， 如 图 5-3 所 示 。 











Project metadata 


Group 


Artifact 


Language 4 Java 


Spring Boot Version5 1.3.0M1 

















图 5-3 ”填写 项 目 信 息 
内 容 解释 


局 我 们 在 此 以 Maven 作 为 项 目 构 建 方式 ，Spring Boot 还 文 
持 以 Gradle 作 为 项 目 构建 工具 ; 


人 @ 部 署 形 式 以 jar 包 形式 ， 当 然 也 可 以 用 传统 的 war 包 形 
式 ， 我 们 将 在 10.2.2 节 进行 讲解 ; 


G@)Java 版 本 我 们 选用 1.8，Spring ”Boot 最 低 要 求 为 1.6， 和 和 
Spring 框架 4.x 的 最 低 要 求 一 致 ; 


(Spring boot 还 支持 以 Groovy 语 言 开发 ， 考 虑 到 本 书 的 受 
众 ， 本 书 以 Java 作 为 开发 语言 ; 


按照 5.1.4 节 的 阐述 ， 选 择 Spring Boot 版 本 为 1.3.0 里 程 碑 
版 本 。 


(3) 选择 项 目 选 用 的 技术 〈 即 starter pom) ， 如 图 5-4 所 











ZN o 


Project dependencies 


Core 


Security 

AOP 

Atomikos (JTA) 
Bitronix (JTA) 
Cache 


DevTools 


Template Engines 
Freemarker 
Velocity 
Groovy Templates 
Thymeleaf 


Mustache 


图 5-4 


内 容 解释 





Web 


r4 


Web 

Websocket 

WS 

Jersey (JAX-RS) 
Vaadin 

Rest Repositories 
HATEOAS 

Mobile 


Data 





JDBC 

JPA 
MongoDB 
Redis 
Gemfire 
Solr 


Elasticsearch 


选择 项 目 选用 的 技术 


这 里 备 选 的 每 一 项 技术 都 是 Spring boot 的 starter pom， 例 如 
我 们 选中 的 Web， 就 是 在 Maven 里 依赖 spring-boot-starter-web 。 


当 这 些 技术 的 starter 





pom 被 选中 后 ， 与 这 项 技术 相关 的 


Spring 的 Bean 将 会 被 目 动 配置 ， 我 们 将 在 第 三 部 分 讲述 常用 的 


starter pom. 


(4) 下 载 代 码 ， 如 图 5-5 所 示 。 


_) Facebook Batch 


| Linkedin Integ 
D) Twitter | JMS 
AMQ 
Mail 

Ops 


I Actuator 


.j Remote Shell 


© Generate Project 


B ch5 2 Lzip - 360 压 缩 3.2 正 式 版 











会 (= | BB ch 2 Lzipch 2 1 - 解 包 大 小 为 3.0 KB 


— 


压缩 前 





Tİ pom.xml 





图 5-5 FARE 
内 容 解释 
此 处 生成 的 是 一 个 简单 的 基于 Maven 的 项 目 ， 无 任何 特 


别 ， 可 将 这 个 项 目 导 入 到 你 种 用 的 开发 工具 中 《〈 见 附录 
A.2. ) 











5.2.2 Spring Tool Suite 


对 于 习惯 于 Eclipse 开发 项 目的 读者 ， 使 用 STS 来 构建 Spring 
Boot 也 十 分 简单 。 


(1) 新 建 Spring Starter Project， 如 图 5-6 所 示 。 











E xr] 
[on Spring - Spring Tool Suite 
| File Edit Navigate Search Project Run Window Help 
| New Alte Shift+N » 
| Open File. (Ej Import Spring Getting Started Content 
Close Ctrl -W G Spring Project 
JS ‘ 
Close All Ctrl+Shift+w | Java Project 
“| 前 Static Web Project 
3e eS C$ Dynamic Web Project 
= Ce _ | Maven Project 
Save All Ctrl+Shift+S T$ Project. 
Revert 
Pe hamaan 











图 5-6 “新建 Spring Starter Project 
(2) 填写 项 目 信 息 和 选择 技术 ， 如 图 5-7 所 示 。 








© 


New Spring Starter Project 





ch5_2 2 


Type: Maven Project v 


Java Version: 18 v 


Boot Version: 1.3.0 M1 





Group com.wisely 


Artifact ch522 





Version 0.0.1-SNAPSHOT 
Description Spring Boot Setup Demo 





Package [com.wisely.chS 2 2 


Dependencies 





口 AMQP 
AWS Messaging 
C Batch 
Cloud Bus AMQP 
Config Server 
Eureka Server 
C] Gemfire 
CI HSQLDB 
L]JDBC 
C LinkedIn 
C] Mustache 
C] Redis 
CI Security 
Turbine AMQP 
Ows 


L]AOP 
(J Actuator 
C Bitronix UTA) 


C] Cloud Connectors 


C] DevTools 
C] Facebook 


AWS 
[] Apache Derby 
C Cache 
Cloud Security 
{_]Elasticsearch 
| Feign 


Cl Groovy Templates | ]H2 


Hystrix 
(jms 
L1 Mail 
LI MySQL 
[C] Remote Shell 
C Solr 
C Twitter 
[v] Web 


Hystrix Dashboard 
(JPA 
口 Mobile 

OAuth2 
[ Rest Repositories 
L]Thymeleaf 
[C] Vaadin 
[C] Websocket 


AWS JDBC 
[C] Atomikos (TA) 
Cloud Bootstrap 
Config Client 
Eureka 
[C] Freemarker 
CI HATEOAS 
[_|Integration 
[Jersey UAX-RS) 
[L]MongoDB 
[C PostgreSQL 
Ribbon 
Turbine 
C] Velocity 
Zuul 








© 


图 5-7 


< Back 





a] a Cee 





填写 项 目 信 息 和 选择 技术 
(3) 项 目 结 构 如 图 5-8 所 示 。 


&5 ch5 22 
v ($8 src/main/Java 


v 册 com.wisely.ch5 2 2 
> |j] Ch522Applicationjava 


> (8 src/main/resources 


> (jS src/test/Java 


> BA JRE System Library [JavaSE-1.8] 
^ má Maven Dependencies 
^ B&B src 

& target 

[m] pom.xml 





图 5-8 项 目 结构 


(4) 依赖 树 如 图 5-9 所 示 。 


Dependency Hierarchy 日 国 | 局 m [35] 


vi | pring-boot-starter-web : 1.3.0.M1 [compile]: 









v. ©) spring-boot-starter : 1.3.0.M1 [compile] 
spring-boot : 1.3.0.M1 [compile] 
spring-boot-autoconfigure : 1.3.0.M1 [compile] 


> 


> 


1 C 


spring-boot-starter-logging : 1.3.0.M1 [compile] 
spring-core : 4.2.0.RC1 (omitted for conflict with 4.2.0.RC1) [1 


C3 snakeyaml : 1.15 [compile] 
G spring-boot-starter-tomcat : 1.3.0.M1 [compile] 
(3 spring-boot-starter-validation : 1.3.0.M1 [compile] 


jackson-databind : 2.5.4 [compile] 


> (© spring-web : 4.2.0.RC1 [compile] 











> ©) spring-webmvc : 4.2.0.RC1 [compile] 
v © spring-boot-starter-test : 1.3.0.M1 [test] 
v o junit : 4.12 [test] 
C) hamcrest-core : 1.3 (omitted for conflict with 1.3) [test] 
v © mockito-core : 1.10.19 [test] 
o hamcrest-core : 1.3 (managed from 1.1) (omitted for conflict 
o objenesis : 2.1 [test] 
C) hamcrest-core : 1.3 [test] 
v © hamcrest-library : 1.3 [test] 
C) hamcrest-core : 1.3 (omitted for conflict with 1.3) [test] 
O spring-core : 4.2.0.RC1 [compile] 
v " spring-test : 4.2.0.RC1 [test] 





spring-core : 4.2.0.RC1 (omitted for conflict with 4.2.0.RC1) [i 














图 5-9 ”依赖 树 
5.2.3 IntelliJ IDEA 


IntelliJ IDEA E ECBHESSBUJT A TIA, SORTA 8 — 
时 间 的 支持 ;使 用 IntelliJ] IDEA ”14.1 版 本 可 直接 新 建 Spring 
Boot 项 目 。 


(1) 新 建 Spring Initializr 项 目 ， 如 图 5-10 所 示 。 


9l New Project x 





图 5-10 “新建 Spring Initializr 项 目 


(2) 填写 项 目 信 息 ， 如 图 5-11 所 示 。 


9I New Project x 














图 5-11 填写 项 目 信 息 


(3) 选择 项 目 使 用 技术 ， 如 图 5-12 所 示 。 


9l New Project x 





图 5-12 ”选择 项 目 使 用 技术 
(4) 填写 项 目 名 称 ， 如 图 5-13 所 示 。 


引 New Project x 





图 5-13 ”填写 项 目 名 称 


(5) 将 项 目 设 置 为 Maven 项 目 ， 如 图 5-14 所 示 。 


1l file found: 


eer\cna 





图 5-14 ”设置 为 Maven 项 目 


(6) 项 目 结构 及 依赖 树 如 图 5-15 所 示 。 


Jl ch5 2 3 - [E\Workspaces\workspace-career\ch5_2_3] - Intelli) IDEA 14.1.3 = 口 X 
le Edit View Na 3 A 





图 5-15 项目 结构 及 依赖 树 


5.2.4 Spring Boot CLI 





Spring Boot CLI 是 Spring Boot 提 供 的 控制 台 命令 工具 。 
1. 下 载 Spring Boot CLI 
Spring Boot 1.3.0.M1 的 下 载 地 址 是 : 


http://repo.spring.io/release/org/springframework/boot/spring- 
boot-cli/1.3.0.RELEASE/spring-boot-cli-1.3.0.RELEASE-bin.zip 


2. 解 压 并 配置 到 环境 变量 


解压 后 将 CLI 的 bin 目录 添 加 到 环境 变量 的 Path 中 ， 这 样 我 
们 就 可 以 在 控制 台 直 接 调 用 Spring Boot CLI 了 ， 如 图 5-16 所 
ZN o 


4p 


wisely 的 用 户 变量 (U) 


变量 值 
计算 机 4 MOZ PLUGIN PA... ae Files\Foxit ee R... 


编辑 系统 变量 


变量 名 (N): 





SERHB(V): 


T 
Path C:\ProgramData\Oracle\Java\javapath;C... 
PATHEXT .COM;.EXE;.BAT;.CMD;.VBS;. VBE; JS; JSE;.... 
PROCESSOR AR.. AMD64 
PROCESSOR IDE... Intel64 Family 6 Model 58 Stepping 9, G... 


FEW)... SS... 删除 (LD) 





图 5-16 ”将 bin 目 录 添 加 到 环境 变量 的 Path 中 
3. 使 用 命令 初始 化 项 目 
要 想 实 现 上 面 几 个 例子 的 效果 ， 需 在 控制 台 输 入 以 下 命 








Spring init --build=maven --java-version=1.8 -- 
dependencies=web --packaging=jar --boot-version-1.3.0.M1 -- 
groupId=com.wisely --artifactId=ch5_2 4 


运行 效果 如 图 5-17 所 示 。 


version-1.8 --dependencies=web --pa 
om wisely  --artifactld-chb 2 4 





4. 项 目 结构 


从 图 5-18 同 样 可 以 看 出 这 是 一 个 普通 的 Maven 项 目 。 


BB ch5_2 4.zip - 360 压 缩 3.2 正 式 版 文件 ”操作 IB 
D , wv 
B 2 4x 7 
添加 解压 到 一 键 解压 Te 

会 党 BE ch5_2 4.zip - 解 包 大 小 为 3.0 KB 





£ tf£zB. TRE sk 





(1. CERE) 文件 去 
H src 文件 夫 
pom.xml 2.2 KB 1 KB XML 文件 





图 5-18 项目 结构 


5.2.5 “Maven 手 工 构建 





前 面 我 讲述 了 用 不 同 的 方式 构建 Spring _ Boot 项目， 但 事实 
上 建立 的 只 是 一 个 Maven 项 目 ， 如 果 不 借 助 上 面 的 方式 ， 我 们 
应 如 何 构建 Spring Boot 项 目 呢 ? 


1.Maven 项 目 构 建 


我 们 可 以 用 任意 开发 工具 新 建 空 的 Maven 项 目 ， 在 1.2 市 已 
经 做 了 较为 详细 的 讲解 。 


2. 修 改 pom.xml 


(1) 添加 Spring ”Boot 的 父 级 依赖 ， 这 样 当前 的 项 目 就 古 
Spring Boot H 了 。spring-boot-starter-parent 是 一 个 特殊 的 
starter， 它 用 来 提供 相关 的 Maven 默 认 依赖 ， 使 用 它 之 后 ， 常 
用 的 包 依 赖 可 以 省 去 version 标 签 ， 关 于 Spring Boot 提 供 了 哪些 
jar 包 的 依赖 ， 可 查看 C: \Users\ 用 户 
\.m2\repository\org\springframework\boot\spring-boot- 
dependencies\1.3.0.M1\spring-boot-dependencies-1.3.0.M1.pom X: 


件 中 的 声明 。 





<parent> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-parent</artifactId> 
<version>1.3.0.M1</version> 
<relativePath/> 

</parent> 


(2) 在 dependencies 添 加 Web 文 持 的 starter pom， 这 样 就 添 
加 了 Web 的 依赖 。 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter- 
web</artifactId> 
</dependency> 


(3) 添加 Spring Boot 的 编译 插件 。 


<build> 
<plugins> 
<plugin> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-maven- 
plugin</artifactId> 
</plugin> 
</plugins> 
</build> 








(4) 因为 我 们 使 用 的 是 里 程 碑 版 的 Spring Boot, 47 f HH HY 
是 正式 版 则 不 需要 下 面 的 配置 。 





<repositories> 
<repository> 
<id>spring-snapshots</id> 


<name>Spring Snapshots</name> 
<url>https://repo.spring.io/snapshot</url> 
<snapshots> 
<enabled>true</enabled> 
</snapshots> 
</repository> 
<repository> 
<id>spring-milestones</id> 
<name>Spring Milestones</name> 
<url>https://repo.spring.io/milestone</url> 
<snapshots> 
<enabled>false</enabled> 
</snapshots> 
</repository> 
</repositories> 
<pluginRepositories> 
<pluginRepository> 
<id>spring-snapshots</id> 
<name>Spring Snapshots</name> 
<url>https://repo.spring.io/snapshot</url> 
<snapshots> 
<enabled>true</enabled> 
</snapshots> 
</pluginRepository> 
<pluginRepository> 
<id>spring-milestones</id> 
<name>Spring Milestones</name> 
<url>https://repo.spring.io/milestone</url> 
<snapshots> 
<enabled>false</enabled> 
</snapshots> 
</pluginRepository> 
</pluginRepositories> 


5.2.6 fa) FLY ZN 


1. 新 建 Spring Bootlit H 


使 用 上 述 方法 新 建 Spring Boot 项 目 后 ， 生 成 的 项 目的 根 包 
目录 下 会 有 一 个 artifactId+Application 命 名 规则 的 入 口 类 。 如 图 











5-199 TZ « 


v Hj com.wisely.ch5 2 2 


|J] Ch522Application.java 





图 5-19 AZ 
2. 添 加 测试 控制 器 


为 了 演示 简单 ， 我 们 不 再 新 建 控制 器 类 ， 而 是 直接 在 入 口 
类 中 编写 代码 。 








package com.wisely.ch5_2 2; 


import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootAppli 
import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RestController 


@RestController 

@SpringBootApplication //1 

public class Ch522Application { 
QRequestMapping("/") 


String index() { 
return "Hello Spring Boot"; 
} 


public static void main(String[] args) { //2 
SpringApplication.run(Ch522Application.class, args); 


代码 解释 
(VW@SpringBootApplication 


(QSpringBootApplicationzéSpring Boot 项 目的 核心 注解 ， 主 
要 目的 是 开局 自动 配置 。 我 们 将 在 6.1.2 节 中 做 更 详细 的 讲解 。 


(2)main7] 1X: 


这 是 一 个 标准 的 Java 应 用 的 main 方 法 ， 主 要 作用 是 作为 项 
目 启 动 的 入 口 。 我 们 将 在 6.1.1 节 做 更 详细 的 讲解 。 


3. 运 行 效 果 


我 们 可 以 通过 Maven 命 令 ， 运 行 项 目 。 











mvn spring-boot:run 


或 单 击 Ch522Application 右 键 ， 在 右键 染 单 中 选择 以 Spring 
Boot APP 或 Java Application 运 行 项 目 ， 如 图 5-20 所 示 。 

















| Run As » | pj 1 Run on Server Alt+Shift+X, R 
Validate Gj) 2 Java Application Alt+Shift+X, J 
Replace With > || 3 Spring Boot App Alt+Shift+X, B 

@ GitHub Run Configurations... 











图 5-20 “右键 菜单 
访问 http://localhost: 8080， 结 果 如 图 5-21 所 示 。 


@ localhost:8080 x 


一 QC | D localhost:8080 


Hello Spring Boot 





6% Spring BootfZ 4» 


6.1 基本 配置 


6.1.1 入 口 关 和 @SpringBootApplication 


Spring Boot A —^ 44 7j* Application A O, A O2% 
HUS —"^FmainZ7j7A, ix^ Smain TIES wh — EN HS Java by 
用 的 入 口 方 法 。 在 main 方 法 中 使 用 
SpringApplication.run (Ch522Application.class, args) ， 局 动 


Spring Boot/V F]JJi H - 


(DSpringBootApplicationzéSpring Boot 的 核心 注解 ， 它 是 一 
个 组 合 注解 ， 源 码 如 下 : 


@Target(ElementType. TYPE) 

QRetention(RetentionPolicy.RUNTIME) 

@Documented 

@Inherited 

@Configuration 

@EnableAutoConfiguration 

@ComponentScan 

public @interface SpringBootApplication { 
Class<?>[] exclude() default {}; 
String[] excludeName() default {}; 





(QSpringBootApplication7 fff 3: 42H J @Configuration, 


@EnableAutoConfiguration, @ComponentScan; ZH 
@SpringBootApplication 注 解 ， 则 可 以 在 入 口 类 上 直接 使 用 
@Configuration, @EnableAutoConfiguration, 
@ComponentScan. 


其 中 ， p nn pu Boot 根 据 类 路 径 
中 的 jar 包 依赖 为 当前 前 项 目 进 行 自动 配置 。 


例如 ， 添 加 了 spring-boot-starter-web 依 赖 ， 会 自动 添加 
Tomcat 和 Spring MVC 的 依赖 ， 那 么 Spring Boot 会 对 Tomcat 和 
Spring MVC 进 行 目 动 配置 。 


Mun, Ys S spring-boot-starter-data-jpafK#i, Spring Boot 
会 自动 进行 JPA 相 关 的 配置 。 


Spring Boot 会 自动 扫描 @SpringBootApplication 所 在 类 的 同 
级 包 【〔 如 com.wisely.ch5_2_2) UR FREE Bean (A AIPA 
项 目 还 可 以 扫描 标注 @Entity 的 实体 类 ) 。 建 议 入 口 类 放置 的 
位 置 在 groupId+arctifactID 组 合 的 包 名 下 。 





6.1.2 关闭 特定 的 目 动 配置 





通过 上 面 的 @SpringBootApplication 的 源码 我 们 可 以 看 出 ， 
关闭 特定 的 自动 配置 应 该 使 用 @SpringBootApplication 注 解 的 
exclude 参 数 ， 例 如 : 


@SpringBootApplication(exclude = 
{DataSourceAutoConfiguration.class}) 


6.1.3 ”定制 Banner 


1. 修 改 Banner 


(1) 在 Spring Boot 司 动 的 时 候 会 有 一 个 默认 局 动 图 案 ， 


图 6-1 所 示 。 
EN en 
( )*^ 711" MV. T XXX 
WM MOET? Pt IL )))) 
”| AI LLI LA sirr 
=========|_|==============|  /-/ / / 
:: Spring Boot :: (v1.3.0.M1) 


图 6-1 默认 启动 图 案 
(2) 我 们 在 src/main/resources 下 新 建 一 个 banner.txt。 


D> Bee 


(3) 通过 http://patorjk. com/software/taag i 站 生成 字符 ， 
融入 的 为 “WISELY”， 将 网 站 生成 的 字符 复制 到 banner.txt 中 。 


(4) 这 时 再 启动 程序 ， 图 案 将 变 为 如 图 6-2 所 示 。 








提 #: :HH HH 
iHi: "H: GHE:. His: "tHE pis Mouest Pe Fe 
HH: HH: Hs: He i 
HH: He: tHE: : ## IHHHHHE:: SHHHHHEIII Bi HH 
HH: HH: Hr: GHÉDI1..... Bis Mooses: SS 4ME 
HH: HH: Hi: ## Ht HH: dHEDiiiiii dHEIIiiiiiiiii He 
HH. amc ms. 1HHHHHE:: iHHHHHHHE: IHHHHHHHE ## 
2015-06-23 17:06:39.235 INFO 4936 --- [ main] com.w] 








图 6-2 ”改变 后 的 图 案 
2. 关 闭 banner 
(1) main 里 的 内 容 修改 为 : 


如 


如 


SpringApplication app = new SpringApplication(Ch522Applicatio 
app.setShowBanner(false); 
app.run(args); 


(2) 或 使 用 fluent API 修 改 为 : 


new SpringApplicationBuilder(Ch522Application.class) 
. ShowBanner (false) 
.run(args); 


6.1.4 Spring Boot 的 配置 文件 


Spring “Boot 使 用 一 个 全 局 的 配置 文件 application.properties 
或 application.yml， 放 置 在 srcmain/resources 目 录 或 者 类 路 径 
的 /config 下 。 


Spring ”Boot 不 仅 支 持 常规 的 properties 配 置 文件 ， 还 支持 
yaml 语 言 的 配置 文件 。yaml 是 以 数据 为 中 心 的 语言 ， 在 配置 数 
据 的 时 候 上 共有 和 面 癌 对 象 的 特征 。 


Spring Boot 的 全 局 配置 文件 的 作用 是 对 一 些 默认 配置 的 配 
置 值 进行 修改 。 


1. 简 单 示 例 


将 Tomcat 的 默认 端口 号 8080 修 改 为 9090， 并 将 默认 的 访问 
路 径 “/” 修 改 为 “/helloboot”。 











可 以 在 application.properties 中 添加 : 


server .port=9090 
server .context -path=/helloboot 


或 在 application.yml 中 添加 : 


server: 
port: 9090 
contextPath: /helloboot 


从 上 面 的 配置 可 以 看 出 ， 在 Spring Boot 中 ，context-path、 
contextPath 或 者 CONTEXT_PATH 形 式 其 实 是 通用 的 。 并 且 ， 
yaml 的 配置 更 简洁 清晰 。 目 前 STS 3.7.0 已 开始 支持 yaml 语 言 配 
置 ， 而 PntelliJ IDEA 则 只 对 Spring Boot 的 properties 配 置 提供 了 
自动 提示 的 功能 ， 且 @PropertySource 注 解 也 不 支持 加 载 yaml 
文件 。 在 日 常 开发 中 ， 我 们 习惯 于 用 properties 文 件 来 配置 ， 所 
以 目前 推荐 使 用 properties 进 行 配置 。 


在 附录 A.3 中 有 Spring Boot 常 用 配置 的 列表 。 





6.1.5 starter pom 


Spring Boot 为 我 们 提供 了 简化 企业 级 开发 绝 大 多 数 场 景 的 
starter pom， 只 要 使 用 了 应 用 场景 所 需要 的 starter pom， 相 关 的 
技术 配置 将 会 消除 ， 束 可 以 得 到 Spring Boot 为 我 们 提供 的 目 动 
配置 的 Bean。 











1. 官 方 starter pom 


Spring Boot 官 方 提供 


表 6-1 


名 th 


了 如 表 6-1 所 示 的 starter pom. 


官方 提供 的 starter pom 





spring-boot-starter 


Ho g 
Spring Boot 核心 starter， 包 含 自动 配置 、 日 志 、 





spring-boot-starter-actuator 





准 生 产 特 性 ， 用 来 监控 和 管理 应 用 








spring-boot-starter-remote-shell 





提供 基于 ssh 协议 的 监控 和 管理 








spring-boot-starter-amqp 


使 用 spring-rabbit 来 支持 AMQP 





spring-boot-starter-aop 

















使 用 spring-aop 和 Aspect) 支持 面向 切面 编程 





spring-boot-starter-batch 


spring-boot-starter-cache 


对 Spring Batch 的 支持 
对 Spring Cache 抽象 的 支持 





spring-boot-starter-cloud-connectors 


名 R 
spring-boot-starter-data-elasticsearch 
spring-boot-starter-data- gemfire 
spring-boot-starter-data-jpa 


spring-boot-starter-data-mongodb 





对 云 平台 (Cloud Foundry, Heroku ) 提供 的 服务 提供 简化 的 连接 方式 





fi 述 
通过 spring-data-elasticsearch 对 Elasticsearch 支持 
通过 spring-data-gemfire 对 分 布 式 存储 GemFire 的 支持 


对 JPA 的 支持 ， 包 含 spring-data-jpa, spring-orm 和 Hibernate 


通过 spring-data-mongodb, Xt} MongoDB 进行 支持 





spring-boot-starter-data-rest 
spring-boot-starter-data-solr 
spring-boot-starter-freemarker 
spring-boot-starter-groovy-templates 
spring-boot-starter-hateoas 
spring-boot-starter-hornetq 
Spring-boot-starter-integration 


spring-boot-starter-jdbc 


通过 spring-data-rest-webmve 将 Spring Data repository 暴露 为 REST 形式 的 服务 


通过 spring-data-solr 对 Apache Solr 数据 检索 平台 的 支持 
对 FreeMarker 模板 引擎 的 支持 
对 Groovy 模板 引擎 的 支持 


通过 spring-hateoas 对 基于 HATEOAS 的 REST 形式 的 网 络 服务 的 支持 


通过 HometQ 对 JMS 的 支持 
对 系统 集成 框架 spring-integration 的 支持 
对 JDBC 数据 库 的 支持 





spring-boot-starter-jersey 
spring-boot-starter-jta-atomikos 
spring-boot-starter-jta-bitronix 


spring-boot-starter-mail 


对 Jersery REST 形式 的 网 络 服务 的 支持 
通过 Atomikos 对 分 布 式 事务 的 支持 
通过 Bitronix 对 分 布 式 事务 的 支持 

对 javax.mail 的 支持 





spring-boot-starter-mobile 


spring-boot-starter-mustache 


对 spring-mobile 的 支持 
对 Mustache 模板 引 黎 的 支持 





spring-boot-starter-redis 
spring-boot-starter-security 


spring-boot-starter-social-facebook 


对 键 值 对 内 存 数 据 库 Redis 的 支持 ， 包 含 spring-redis 
对 spring-security 的 支持 
通过 spring-social-facebook 对 Facebook 的 支持 





spring-boot-starter-social-linkedin 
spring-boot-starter-social-twitter 
spring-boot-starter-test 
spring-boot-starter-thymeleaf 


spring-boot-starter-velocity 


通过 spring-social-linkedin 对 Linkedin 的 支持 
通过 spring-social-twitter 对 Twitter 的 支持 


对 常用 的 测试 框架 JUnit、Hamcrest 和 Mockito 的 支持 ， 包含 spring-test 模块 


对 Thymeleaf 模板 引擎 的 支持 ， 包 含 于 Spring 整合 的 配置 
对 Velocity 模板 引擎 的 支持 





spring-boot-starter-web 
spring-boot-starter-Tomcat 
spring-boot-starter-Jetty 
spring-boot-starter-undertow 


spring-boot-starter-logging 


对 Web 项 目 开 发 的 支持 ， 包 含 Tomcat 和 spring-webmve 
Spring Boot IWA ÑY Servlet 容器 Tomcat 
使 用 Jeny 作为 Servlet AHHH Tomcat 


yaml PERSER 





使 用 Undertow 作为 Servlet 容器 替换 Tomcat 
Spring Boot 默认 的 日 志 框 名 Logback 





spring-boot-starter-log4j 
spring-boot-starter-websocket 


spring-boot-starter-ws 


支持 使 用 Log4J 日 志 框架 
对 WebSocket 开发 的 支持 
对 Spring Web Services 的 支持 


2.98 — 77 starter pom 


除 官方 的 starter pom 外 ， 还 有 第 三 方 为 Spring Boot 所 写 的 
starter pom， 如 表 6-2 所 示 。 


表 6-2 第 三 方 所 写 的 starter pom 




































名 称 地 址 
Handlebars https://github.com/allegro/handlebars-spring-boot-starter 
Vaadin https://github.com/vaadin/spring/tree/master/vaadin-spring-boot-starter 
Apache Camel https://github.com/apache/camel/tree/master/components/camel-spring-boot 
WRO4J https://github.com/sbuettner/spring-boot-autoconfigure-wro4j 
Spring Batch ( 高 级 用 | https://github.com/codecentric/spring-boot-starter-batch-web 
法 ) 
HDIV https://github.com/hdiv/spring-boot-starter-hdiv 
Jade Templates ( Jade4J ) | https://github.com/domix/spring-boot-starter-jade4j 
Actitivi https://github.com/Activiti/Activiti/tree/master/modules/activiti-spring-boot/spring-boot-starters 


6.1.6 ”使 用 xml 配 置 


Spring ” ”Boot 提倡 零 配置 ， 即 无 xml 配 置 ， 但 是 在 实际 项 目 
中 ， 可 能 有 一 些 特殊 要 求 你 必须 使 用 xml 配 置 ， 这 时 我 们 可 以 
通过 Spring 提 供 的 @ImportResource 来 加 载 xml 配 置 ， 例 如 : 





@ImportResource({"classpath:some- 
context.xml","classpath:another-context.xml")) 


6.2 ”外 部 配置 





Spring Boot 人 允许 使 用 properties 文 件 、yaml 文 件 或 者 命令 行 
参数 作为 外 部 配置 。 


6.2.1 命令 行 参 数 配 置 


Spring Boot 可 以 是 基于 jar 包 运行 的 ， 打 成 jar 包 的 程序 可 以 
直接 通过 下 面 命令 运行 : 


java -jar xx.jar 


nf EDJ3S E EA P a fep Tomcat? AS: 


java -jar xx.jar --server.port-9090 


6.2.2 HABEAS 


在 2.2 节 我 们 讲述 了 在 常规 Spring 环境 下 ， 注 入 properties 文 
件 里 的 值 的 方式 ， 通 过 @PropertySource 指 明 properties 文 件 的 
位 置 ， 然 后 通过 @Value 注 入 值 。 在 Spring Boot#, FRR i 
在 application.properties 定 义 属 性 ， 直 接 使 用 @Value 注 入 即 可 。 


1. 实 战 
在 上 例 的 基础 上 ， 进 行 如 下 的 修改 。 
(1) application.properties 增 加 属性 : 


book .author=wangyunfei 
book . name 


=spring boot 


(2) 修改 入 口 类 : 


package com.wisely.ch5_2 2; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootAppli 
import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RestController 


@RestController 
@SpringBootApplication 
public class Ch522Application { 


@Value("${book.author}") 
private String bookAuthor; 
@Value("${book.name}" ) 
private String bookName; 


QRequestMapping("/") 
String index() { 
return "book name is:"+bookName+" and book author 
} 


public static void main(String[] args) { 
SpringApplication.run(Ch522Application.class, args); 


(3) 运行 ， 访 问 http://localhost: 9090/helloboot/, XR 40 
图 6-3 所 示 。 





localhost:9090/hellobo- x 


€ œŒ | [5 localhost:9090/helloboot/ 


book name is:spring boot and book author is:wangyunfei 





Kle-3 ”运行 效果 


6.2.3 ”类 型 安全 的 配置 〈 基 于 properties ) 








上 例 中 使 用 @Value 注 入 每 个 配置 在 实际 项 目 中 会 显得 格外 
RIS, BABII ACE er AT. EHI EAIA XU 
要 使 用 @Value 注 入 很 多 次 。 


Spring Boot 还 提供 了 基于 类 型 安全 的 配置 方式 ， 通 过 
@ConfigurationProperties 将 properties 属 性 和 一 个 Bean 及 其 属性 
关联 ， 从 而 实现 类 型 安全 的 配置 。 

1. 实 战 

(1) 新 建 Spring Boot 项 目 ， 如 图 6-4 所 示 。 





chó 2 3 


Version 0.0.1- SNAPSHOT 


Package com witely.ch6 2 3 
Dependennes 
口 AMQP AWS AWS JDBC 
AWS Messaging |. J Apache Derby LJ Atermikos UTA) 
L.] Batch |. Cache Coud Bootstrap 
Cloud Bus AMQP [ jClowd Connectors Cloud Security Config Client 
Contig Server M DevTools j > Eureka 
Eureka Server [_] Facebook Feign L]Freemarker 
Gemfre C Groovy Templates | H2 
口 HSQLDB Hyttra Hystrix Dashboard [Integration 
_ IDRC LJ DmA DJervey UAX-RS) 
Jt LJMobile DMongoD8 
Cauth2 [PostgreSQL 
(Rest Repositories Ribbon 
LJ Thymeleat Turbine 
C Vaadin C] Velocity 
l Websocket čuu! 





图 6-4 ”新建 Spring Boot 项 目 


(2) 添加 配置 ， 即 在 application.properties 上 添加 : 


author .name=wyf 
author.age 


=32 


“PR, BAILY b re&-—-^ properties £F, 320b ra 28 344] 
1t @ConfigurationProperties[) & locations Œ $8 XE properties’) 
位 置 ， 且 需要 在 入 口 类 上 配置 。 


(3) 类 型 安全 的 Bean， 代 人 码 如 下 : 





package com.wisely.ch6 2 3.config; 
import org.springframework.boot.context.properties.Configurat 


@Component 
@ConfigurationProperties(prefix = "author") //1 
public class AuthorSettings { 

private String name; 

private Long age; 


public String getName() { 


return name; 
} 


public void setName(String name) { 
this.name = name; 
} 


public Long getAge() { 
return age; 
} 


public void setAge(Long age) { 
this.age = age; 
} 


代码 解释 


通过 @ConfigurationProperties 加 载 properties 文 件 内 的 配 
置 ， 通 过 prefix 属 性 指定 properties 的 配置 的 前 经， 通过 ]ocations 
指定 properties 文 件 的 位 置 ， 例 如 : 


ZN o 


@ConfigurationProperties(prefix = "author", locations = ("clas 


本 例 不 需要 配置 locations。 
(4) 检验 代码 : 


package com.wisely.ch6_2_3; 


import 
import 
import 
import 
import 


import 


org.springframework.beans.factory.annotation.Autowired 
org.springframework.boot.SpringApplication; 

org.springframework.boot.autoconfigure.SpringBootAppli 
org.springframework.web.bind.annotation.RequestMapping 
org.springframework.web.bind.annotation.RestController 


com.wisely.cho6 2 3.config.AuthorSettings; 


QRestController 
QSpringBootApplication 


public 


class Ch623Application { 


@Autowired 
private AuthorSettings authorSettings; //1 


QRequestMapping("/") 
public String index(){ 


j 


return "author name is "+ authorSettings.getName()-" 


public static void main(String[] args) { 


SpringApplication.run(Ch623Application.class, args); 


代码 解释 
可 以 用 @Autowired 直 接 注入 该 配置 。 


(5) 运行 ， 访 问 : http://localhost: 8080/， 效 果 如 图 6-5 所 





j @ localhost:8080 


> C DO ER: A 











author name is wyf and author age is 32 





63 日 志 配 置 


Spring Boot 文 持 Java Util Logging、Log4J、Log4J2 和 
Logback 作 为 日 志 框 架 ， 无 论 使 用 哪 种 日 志 框 架 ，Spring Boot 
己 为 当前 使 用 日 志 框 架 的 控制 台 输 出 及 文件 输出 做 好 了 配置 ， 
可 对 比 4.2.2 节 中 没有 Spring Boot 时 日 志 配 置 的 方式 。 

默认 情况 下 ，Spring Boot 使 用 Logback 作 为 日 志 框 架 。 

配置 日 志 级 别 : 


logging.file=D:/mylog 


/log.log 


配置 日 志文 件 ， 格 式 为 logging.level. 包 名 = 级 别 : 


logging.level.org.springframework.web- DEBUG 


6.4 Profilet B. 


Profile 是 Spring 用 来 针对 不 同 的 环境 对 不 同 的 配置 提供 文 持 
的 ， 全 局 Profile 配 置 使 用 application-{profile}.properties 《如 
application-prod.properties) . 


通过 在 application.properties 中 设置 
spring.profiles.active=prod 来 指定 活动 的 Profile。 


下 面 将 做 一 个 最 简单 的 演示 ， 如 我 们 分 为 生产 (prod) 和 
开发 (dev) 环境 ， 生 产 环境 下 端口 号 为 80， 开 发 环境 下 端口 
为 8888。 

SE AK 


(1) 新 建 Spring Boot 项 目 ， 如 图 6-6 所 示 。 


New Spring Starter Project 


Name 


Type: Maven Project v Packaging: 
Java Version: Language: 
Boot Version: 

Group 

Artifact 


Version 0.0.1-SNAPSHOT 


Description Demo project for Spring Boot 


Package com.wisely.ch6 4 


Dependencies 
| ]JAMQP AOP AWS AWS JDBC 

AWS Messaging Actuator Apache Derby [.] Atomikos (JTA) 
[ ]Batch Bitronix (JTA) Cache Cloud Bootstrap 


Cloud Bus AMQP Cloud Connectors Cloud Security Config Client 











BL T UI 








Config Server [ ]DevTools [ ]Elasticsearch Eureka 





Eureka Server Facebook Feign Freemarker 
Groovy Templates [] H2 | ]HATEOAS 

[ ]HSQLDB Hystrix Hystrix Dashboard [ ]Integration 
JDBC JMS JPA | |Jersey UAX-RS) 
LinkedIn Mail C] Mobile [C] MongoDB 
Mustache MySQL OAuth2 |_| PostgreSQL 
Redis Remote Shell Rest Repositories Ribbon 
Security Solr Thymeleaf Turbine 
Turbine AMQP Twitter Vaadin |_| Velocity 


| ]WS Web [ |Websocket Zuul 





[ ] Gemfire 























E iN JL E I] 



































; 





图 6-6 ”新 建 Spring Boot 项 目 
(2) 生产 和 开发 环境 下 的 配置 文件 如 下 : 


application-prod.properties: 


server .port=80 


application-dev.properties: 


server .port=8888 


此 时 目录 结构 如 图 6-7 所 示 。 


v 册 com.wisely.ch6_4 
v [$8 src/main/resources 
© static 
(= templates 


application-dev.properties 


application-prod.properties 





Æ application.properties 
图 6-7 目录 结构 
( 3 ) 运行 o 
application.properties? JI: 


spring.profiles.active-dev 


司 动 程序 结果 为 : 


Registering beans for JMX exposure on startup 


Tomcat started on port(s):/ 8888 |(http) 
Started Ch64Application in 2.403 seconds (JVM running for 2.755) 


修改 application.properties: 


spring.profiles.active-prod 


6.5 Spring Boot 运 行 原理 


在 前 面 几 个 章节 ， 我 们 见识 了 Spring Boot 为 我们 做 的 自动 
配置 ， 为 了 让 大 家 快速 领略 Spring Boot 的 魅力 ， 我 们 将 在 本 节 
先 通过 分 析 Spring Boot 的 运行 原理 后 ， 根 据 已 掌握 的 知识 目 定 


义 一 个 starter pom. 


在 3.5 章 中 我 们 了 解 到 Spring 4.x 提 供 了 基于 条 件 来 配置 
Bean 的 能 力 ， 其 实 Spring Boot 的 神奇 的 实现 也 是 基于 这 一 原理 
的 。 

本 节 虽 然 没 有 捍 在 书 的 显著 位 置 ， 但 是 本 节 的 内 容 是 理解 
Spring ”Boot 运 作 原 理 的 关键 。 我 们 可 以 借助 这 一 特性 来 理解 
Spring Boot 运 行 目 动 配置 的 原理 ， 并 实现 自己 的 自动 配置 。 


Spring Boot 关 于 自动 配置 的 源码 在 spring-boot- 
autoconfigure-1.3.0.x.jar 内 ， 主 要 包含 了 如 图 6-8 所 示 的 配置 。 


























v #8 org.springframework.boot.autoconfigure 
出 admin 
^ Bj amap 
^ 8i aop 
H3 batch 
H3 cache 
; £8 cloud 
8 condition 
册 dao 
册 data 
> 8&8 elasticsearch 
^ Œ flyway 
册 freemarker 
册 groovy.template 
> £8 gson 
H3 hateoas 
Bi integration 
&3 jackson 
册 jdbc 
Hi jersey 
^ B jms 
册 jmx 
Œ liquibase 
”出 logging 
^ & mail 
#8 mobile 
册 mongo 
Ej mustache 
> 8j ormjpa 
` BB reactor H3 template 
Hi redis 册 thymeleaf 
， 册 security 册 transaction 
^ —B sendgrid Bi velocity 
Bi social 8 web 
^ Œ solr > 册 websocket 


图 6-8 包含 的 配置 


Ti AE Spring Boot 为 我 们 做 了 哪些 自动 配置 ， 可 以 查看 
这 里 的 源码 。 


可 以 通过 下 面 三 种 方式 得 看 当前 项 目 中 已 后 用 和 未 司 用 的 
目 动 配置 的 报告 。 


(1) 运行 jar 时 增加 --debug 参 数 : 























java -jar xx.jar --debug 


(2) 在 application.properties 中 设置 属性 : 


debug=true 


(3) 在 STS 中 设置 ， 如 图 6-9 所 示 。 


















— 


-e-r G86" S57 





1 Ch64Application 
2 Ch522Application 
3 Ch623Application 





邻 全 日 日 日 


Ju 6 ProcessTestLaptopHumanProcess 


Run As 


4 ch5 2 2 - Ch522Application 
5 Pivotal tc Server Developer Edition v3.1 





| Run Configurations. | 


Organize Favorites... 


| Name: Ch64Application 








[c] Main (09 Arguments BA JRE o Classpath W Source m Environment. m Gommon 


Program arguments: 


VM arguments: 


-Ddebug 


Working directory: 


@ Default: 


© Other: 


${workspace_loc:ch6_4} 


m 


Apply 


Variables... 


Variables... 


Variables. 


Revert 





图 6-9 在 STS 中 设置 


此 时 局 动 ， 可 在 控制 从 输出 。 已 局 用 的 上 自动 配置 为 : 


Dispatcher: Aa EA Ms ind oe 
- @ConditionalOnClass classes fou -springframework.web.s rvlet.DispatcherServlet (OnClassCondition) 
- found ica applica zu nists ae ison sif v ironment (OnWel bapplic ae e ndition) 


pou rServletAutoCon men ration e pper enie nfigur: 
- @ConditionalonClass classes found: jav: rvlet.Servle e ed stration (OnClassCondition) 
- no ServletRegistr: RE nBea! DERE d (Dispa RE E rServletAutoConfiguration.Defa AP spatcherServletCondition) 


tabecdemervie 'tContaij 
web applic ils sm eh vds ie 'tEnvironment (OnWebApplicationCondition) 


未 局 用 的 自动 配置 为 : 


RE 
d @ConditionalOnClass classes not found: javax.jms.ConnectionFactory,org.apache.activemq.ActiveMQCo 


eM utoConfigur 
quired deus nditio nalOnClass classes not found: org.aspectj.lang.annotation.Aspect,org.aspectj.lang.reflec 


BatchAutoConfigur 
required am itio nalOnClass classes not found: org.springframework.batch.core.launch.JobLauncher,org.spri 


Ca chan finr 
- GCon 


ee s classes found: org.s| 
ae 


ringframework.cache.CacheManager (OnClassCondition) 
- @Con em Em nalOnBea Cae: org-springfrai k 


rk.cache.interceptor.CacheAspectSupport; SearchStrategy: all) 


6.5.1 运作 原理 


关于 Spring Boot 的 运作 原理 ， 我 们 还 是 回归 到 
@SpringBootApplication 注 解 上 来 ， 这 个 注解 是 一 个 组 合 注 
解 ， 它 的 核心 功能 是 由 @EnableAutoConfiguration 注 解 提 供 
的 。 


下 面 我 们 来 看 下 @EnableAutoConfiguration 注 解 的 源码 : 


@Target(ElementType. TYPE) 
QRetention(RetentionPolicy.RUNTIME) 
@Documented 
@Inherited 
@Import({ EnableAutoConfigurationImportSelector.class, 
AutoConfigurationPackages.Registrar.class }) 

public @interface EnableAutoConfiguration { 

Class<?>[] exclude() default {}; 

String[] excludeName() default {}; 


这 里 的 关键 功能 是 @Import 注 解 导 入 的 配置 功能 ， 
EnableAutoConfigurationImportSelector 使 用 
SpringFactoriesLoader.loadFactoryNames 方 法 来 扫描 具有 META- 
INF/spring.factories 文 件 的 jar 包 ， 而 我 们 的 spring-boot- 
autoconfigure-1.3.0.x.jar 里 就 有 一 个 spring.factories 文 件 ， 此 文件 
中 声明 了 有 哪些 自动 配置 ， 如 图 6-10 所 示 。 














B spring.factories 25 
1# Initializers 
2org.springframework.context.ApplicationContextInitializer=\ 
3 org.springframework.boot.autoconfigure.logging.AutoConfigurationReportLloggingInitializer 
5# Auto Configure 
6 org.springframework.boot.autoconfigure.EnableAutoConfiguration-V 
7 org. springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration,V 
8 org. springframework.boot.autoconfigure.aop.AopAutoConfiguration, 
9 org. springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration,V 
) org. springframework.boot.autoconfigure.MessageSourceAutoConfiguration, V 
11 org.springframework.boot.autoconfigure.PropertyPlaceholderAutoConfiguration,V 
2 org. springframework.boot.autoconfigure.batch.BatchAutoConfiguration,V 

13 org.springframework.boot.autoconfigure.cache.CacheAutoConfiguration, 

14 org.springframework. boot .autoconfigure.cloud.CloudAutoConfiguration, \ 

15 org. springframework.boot.autoconfigure.dao.PersistenceExceptionTranslationAutoConfiguration,V 

16 org. springframework. boot .autoconfigure.data.elasticsearch.ElasticsearchRepositoriesAutoConfiguration, \ 

17 org. springframework. boot .autoconfigure.data.jpa.JpaRepositoriesAutoConfiguration, \ 

18 org. springframework. boot .autoconfigure.data.mongo.MongoRepositoriesAutoConfiguration, \ 

19 org. springframework. boot. autoconfigure.data.solr.SolrRepositoriesAutoConfiguration,\ 

20 org. springframework. boot .autoconfigure.data.rest.RepositoryRestMvcAutoConfiguration, \ 
org.springframework.boot.autoconfigure.data.web.SpringDataWebAutoConfiguration,V 
org.springframework.boot.autoconfigure.freemarker.FreeMarkerAutoConfiguration,V 
org.springframework.boot.autoconfigure.gson.GsonAutoConfiguration,V 
org.springframework.boot.autoconfigure.hateoas.HypermediaAutoConfiguration,V 
25 org. springframework.boot.autoconfigure.integration.IntegrationAutoConfiguration,V 
26 org. springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration, V 
27 org. springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,V 
28 org. springframework.boot.autoconfigure.jdbc.JndiDataSourceAutoConfiguration,V 
29 org. springframework.boot.autoconfigure.jdbc.XADataSourceAutoConfiguration,V 

9 org. springframework.boot.autoconfigure.jdbc.DataSourceTransactionManagerAutoConfiguration,V 

1org.springframework.boot.autoconfigure.jms.JmsAutoConfiguration,V 
32 org. springframework.boot.autoconfigure.jmx.JmxAutoConfiguration, \ 

33 org.springframework.boot.autoconfigure. jms . IndiConnectionFactoryAutoConfiguration, \ 


图 6-10 ”自动 配置 























6.5.2 ”核心 注解 


打开 上 面 任意 一 个 AutoConfiguration 文 件 ， 一 般 都 有 下 面 
的 条 件 注解 ， 在 spring-boot-autoconfigure-1.3.0.x.jar 的 
org.springframwork.boot.autoconfigure.condition 包 下 ， 条 件 注 解 


如 下 。 





@ConditionalOnBean: 当 容 器 里 有 指定 的 Bean 的 条 件 下 。 
@ConditionalOnClass: 当 类 路 径 下 有 指定 的 类 的 条 件 下 。 


@ConditionalOnExpression: 基于 SpEL 表 达 式 作为 判断 条 
fF. 


(2ConditionalOnJava: 基于 JVM 版 本 作为 判断 条 件 。 


@ConditionalOnJndi: 在 JNDI 存 在 的 条 件 下 查找 指定 的 位 
置 。 


@ConditionalOnMissingBean: 当 容 右 里 没有 指定 Bean 的 情 
i b. 


@ConditionalOnMissingClass: 当 类 路 径 下 没有 指定 的 类 的 
条 件 下 。 


@ConditionalOnNotWebApplication: 当前 项 目 不 是 Web 项 
目的 条 件 下 。 


@ConditionalOnProperty: 指定 的 属性 是 否 有 指定 的 值 。 


@ConditionalOnResource: 类 路 径 是 否 有 指定 的 值 。 


























@ConditionalOnSingleCandidate: 当 指 定 Bean 在 容器 中 只 
有 一 个 ， 或 者 虽然 有 多 个 但 是 指定 首选 的 Bean。 


@ConditionalOnWebApplication: 当前 项 目 是 web 项 目的 条 
fF. 


这 些 注解 都 是 组 全 了 @Conditional 元 注解 ， 只 是 使 用 了 不 
同 的 条 件 (Condition) ， 我 们 在 3.5 节 已 做 过 靖 述 定义 一 个 根 
据 条 件 创建 不 同 Bean 的 演示 。 

















下 面 我 们 用 在 3.5 节 学 过 的 
@ConditionalOnWebApplication?= fff . 


package org. 


import 
import 
import 
import 
import 


import 


j 


java. 
java. 
java. 
java. 
java. 


springframework. 


lang.annotation. 
lang.annotation. 
lang.annotation. 
lang.annotation. 
lang.annotation. 


知识 简单 分 析 一 下 


boot .autoconfigure.condition; 


Documented; 
ElementType; 
Retention; 
RetentionPolicy; 
Target; 


org.springframework.context.annotation.Conditional; 
@Target({ ElementType.TYPE, ElementType.METHOD }) 
QRetention(RetentionPolicy.RUNTIME) 

@Documented 
@Conditional(OnWebApplicationCondition.class) 
public @interface ConditionalOnWebApplication { 





从 源码 可 以 看 出 ， 此 注解 使 用 的 条 件 是 
OnWebApplicationCondition， 下 面 我 们 看 看 这 个 条 件 是 如 何 构 


造 的 : 


package org.springframework.boot.autoconfigure.condition; 


import 
import 
import 
import 
import 
import 
import 
import 
import 


org. 
org. 
org. 
org 
org. 
org. 
org 
org. 
org. 


springframework. 
springframework. 
springframework. 


.springframework. 


springframework. 
springframework. 


.springframework. 
.web.context.WebApplicationContext; 
.web.context.support.StandardServle 


springframework 
springframework 


context.annotation.Condition; 
context.annotation.ConditionContex 
core.Ordered; 
core.annotation.Order; 
core.type.AnnotatedTypeMetadata; 
util.ClassUtils; 

util.ObjectUtils; 


QOrder(Ordered.HIGHEST PRECEDENCE + 20) 
class OnWebApplicationCondition extends SpringBootCondition { 


private static final String WEB CONTEXT CLASS - "org.spri 


* "support.Gene 


ricWwebApplicationContext"; 


@Override 
public ConditionOutcome getMatchOutcome(ConditionContext 


j 


AnnotatedTypeMetadata metadata) { 
boolean webApplicationRequired - metadata 
.isAnnotated(ConditionalOnWebApplication.clas 
ConditionOutcome webApplication - isWebApplication(co 


if (webApplicationRequired && !webApplication.isMatch 
return ConditionOutcome.noMatch(webApplication.ge 
} 


if (!webApplicationRequired && webApplication.isMatch 
return ConditionOutcome.noMatch(webApplication.ge 
y 


return ConditionOutcome.match(webApplication.getMessa 


private ConditionOutcome isWebApplication(ConditionContex 


AnnotatedTypeMetadata metadata) { 


if (!ClassUtils.isPresent(WEB CONTEXT CLASS, context. 
return ConditionOutcome.noMatch("web application 
} 


if (context.getBeanFactory() != null) { 
String[] scopes = context.getBeanFactory().getReg 
if (ObjectUtils.containsElement(scopes, "session" 
return ConditionOutcome.match("found web appl 
} 


j 


if (context.getEnvironment() instanceof StandardServl 
return ConditionOutcome 
.match("found web application StandardSer 


j 


if (context.getResourceLoader() instanceof WebApplica 
return ConditionOutcome.match("found web applicat 
} 


return ConditionOutcome.noMatch("not a web applicatio 


从 isWebApplication 方 法 可 以 看 出 ， 判 断 条 件 是 : 
(1) GenericWebApplicationContext 是 否 在 类 路 径 中 ; 
(2) as Het AA Z Nsessionti'scope; 


(3) 当前 容器 的 Enviroment 是 否 为 
StandardServletEnvironment; 





(4) 当前 的 ResourceLoader 是 否 关 
WebApplicationContext (ResourceLoader 是 ApplicationContext 
的 顶级 接口 之 一 ) s 


(5) 我 们 需要 构造 ConditionOutcome 类 的 对 象 来 帮助 我 
们 ， 最 终 通 过 ConditionOutcome.isMatch 方 法 返回 布尔 值 来 确定 
AL 
条 件 。 





6.5.3 ”实例 分 析 





在 了 解 了 Spring Boot 的 运作 原理 和 主要 的 条 件 注解 后 ， 现 
在 来 分 析 一 个 简单 的 Spring ” Boot 内置 的 自动 配置 功能 : http 的 
编码 配置 。 


我 们 在 常规 项 目 中 配置 http 编 码 的 时 候 是 在 web.xml 里 配置 
一 个 filter， 如 : 











<filter> 

<filter-name>encodingFilter</filter-name> 

<filter- 

class>org.springframework.web.filter.CharacterEncodingFilter 

</filter-class> 

«init-param» 

<param-name>encoding</param-name> 

<param-value>UTF -8</param-value> 


</init -param> 

«init-param» 
<param-name>forceEncoding</param-name> 
<param-value>true</param-value> 

</init -param> 

</filter> 





自动 配置 要 满足 两 个 条 件 : 
(1) 能 配置 CharacterEncodingFilter 这 个 Bean:; 
(2) 能 配置 encoding 和 forceEncoding 这 两 个 参数 。 
1. 配 置 参数 
在 6.2.3 节 我 们 讲述 了 类 型 安全 的 配置 ，Spring Boot 的 自动 


配置 也 是 基于 这 一 点 实现 的 ， 这 里 的 配置 类 可 以 在 
application.properties 中 直接 设置 ， 源 码 如 下 : 

















@ConfigurationProperties(prefix = "spring.http.encoding")//1 
public class HttpEncodingProperties { 


public static final Charset DEFAULT_CHARSET = Charset.for 
8") 37/2 


private Charset charset = DEFAULT_CHARSET; //2 
private boolean force = true; //3 
public Charset getCharset() { 


return this.charset; 
} 


public void setCharset(Charset charset) { 
this.charset = charset; 
} 


public boolean isForce() { 
return this.force; 
J 


public void setForce(boolean force) { 
this.force = force; 
} 


代码 解释 


QD 在 application.properties 配 置 的 时 候 前 级 是 
spring.http.encoding; 


地 默认 编码 方式 为 UTF-8， 大 修改 可 使 用 
spring.http.encoding.charset= 编 码 ; 


(3 设置 forceEncoding， 默 认为 tue， 耕 修改 可 使 用 


spring.http.encoding.force=false. 
2. fic E Bean 


通过 调用 上 述 配 置 ， 并 根据 条 件 配置 
CharacterEncodingFilter 的 Bean， 我 们 来 看 看 源码 : 


@Configuration 
@EnableConfigurationProperties(HttpEncodingProperties.class) 
@ConditionalOnClass(CharacterEncodingFilter.class) //2 
@ConditionalOnProperty(prefix = "Spring.http.encoding", value 
public class HttpEncodingAutoConfiguration { 


@Autowired 
private HttpEncodingProperties httpEncodingProperties; // 


@Bean//4 

@ConditionalOnMissingBean(CharacterEncodingFilter.class) 

public CharacterEncodingFilter characterEncodingFilter() 
CharacterEncodingFilter filter - new OrderedCharacter 
filter.setEncoding(this.httpEncodingProperties.getCha 


filter .setForceEncoding(this.httpEncodingProperties.i 
return filter; 


j 


代码 解释 


QD 开启 属性 注入 ， 通 过 @EnableConfigurationProperties 声 
明 ， 使 用 @Autowired 注 入 ; 


@ 当 CharacterEncodingFilter 在 类 路 径 的 条 件 下 ; 


@ 当 设置 Spring.http.encoding=enabled 的 情况 下 ， 如 果 没 有 
设置 则 默认 为 tue， 即 条 件 符合 ; 


由 像 使 用 Java 配 置 的 方式 配置 CharacterEncodingFilter 这 个 


Bean; 


@ 当 容器 中 没有 这 个 Bean 的 时 候 新 建 Bean。 








6.5.4 ”实战 








看 完 前 面 几 市 的 讲述 ， 是 不 是 觉得 Spring Boot 的 目 动 配置 
其 实 很 简单 ， 是 不 是 跃跃欲试 地 想 让 自己 的 项 目 也 有 具备 这 样 的 
功能 。 其 实 我 们 完全 可 以 仿照 上 面 http 编 码 配 置 的 例子 自己 写 
一 个 上 自动 配置 ， 不 过 这 里 再 做 的 彻底 点 ， 我 们 目 己 写 一 个 
starter pom， 这 意味 着 我 们 不 仪 有 自动 配置 的 功能 ， 而 且 具 有 
更 通用 的 耦合 度 更 低 的 配置 。 


为 了 方便 理解 ， 在 这 里 举 一 个 简单 的 实战 例子 ， 包 含 当 茶 
个 类 存在 的 时 候 ， 自 动 配置 这 个 类 的 Bean， 并 可 将 Bean 的 属性 











在 application.properties 中 配置 。 
(1) 新 建 starter 的 Maven 项 目 ， 如 图 6-11 所 示 。 


C. New Maven Project 
New Maven project 
Select project name and location 
C] Create a simple project (skip archetype selection) 


[V] Use default Workspace location 


Cl Add project(s) to working set 


» Advanced 





© New Maven Project 


New Maven project 
Select an Archetype 








Catalog: All Catalogs 
Filter: | 








Group Id Artifact Id 


org.apache.cocoon cocoon-22-archetype-webapp 
org.apache.maven.archetypes maven-archetype-j2ee-simple 
org.apache.maven.archetypes maven-archetype-marmalade-mojo 
org.apache.maven.archetypes maven-archetype-mojo 
org.apache.maven.archetypes maven-archetype-portlet 


-profiles 








[V] Show the last version of Archetype only [ ]Include snapshot archetypes | Add Archetype... 
» Advanced 





(C New Maven Project 


New Maven project 
Specify Archetype parameters 


Artifact Id: spring-boot-starter-hello 





Version: | 0.0.1-SNAPSHOT v| 


Package: [com.wisely spring. boot starter hell} Y 


Properties available from archetype: 








Name Value 

















图 6-11 新建 starter 的 Maven 项 目 


在 pom.xml 中 修改 代码 如 下 : 


«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi- 
instance" 


4. 


xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 http: 
0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<groupId>com.wisely</groupId> 
<artifactId>spring-boot-starter-hello</artifactId> 
<version>0.0.1-SNAPSHOT</version> 
<packaging>jar</packaging> 


<name>spring-boot-starter -hello</name> 
<url>http://maven.apache.org</url> 


<properties> 
<project.build.sourceEncoding>UTF - 


8</project.build.sourceEncoding> 


</properties> 


<dependencies> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot -autoconfigure</artifactId> 
<version>1.3.0.M1</version> 
</dependency> 
<dependency> 
«groupId»junit«/groupId» 
<artifactId>junit</artifactId> 
<version>3.8.1</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 
<!-- 使 用 Spring Boot 正 式 版 时 ， 无 须 下 列 配置 --> 
<repositories> 
<repository> 
<id>spring-snapshots</id> 
<name>Spring Snapshots</name> 
<url>https://repo.spring.io/snapshot</url> 
<snapshots> 
<enabled>true</enabled> 
</snapshots> 
</repository> 
<repository> 
<id>spring-milestones</id> 














<name>Spring Milestones</name> 
<url>https://repo.spring.io/milestone</url> 
<snapshots> 
<enabled>false</enabled> 
</snapshots> 
</repository> 
</repositories> 
<pluginRepositories> 
<pluginRepository> 
<id>spring-snapshots</id> 
<name>Spring Snapshots</name> 
<url>https://repo.spring.io/snapshot</url> 
<snapshots> 
<enabled>true</enabled> 
</snapshots> 
</pluginRepository> 
<pluginRepository> 
<id>spring-milestones</id> 
<name>Spring Milestones</name> 
<url>https://repo.spring.io/milestone</url> 
<snapshots> 
<enabled>false</enabled> 
</snapshots> 
</pluginRepository> 
</pluginRepositories> 
</project> 


代码 解释 
在 此 处 增加 Spring Boot 目 身 的 目 动 配置 作为 依赖 。 
(2) 属性 配置 ， 代 人 码 如 下 : 





package com.wisely.spring_boot_starter_hello; 
import org.springframework.boot.context.properties.Configurat 


QConfigurationProperties(prefix-"hello") 
public class HelloServiceProperties { 


private static final String MSG - "world"; 


private String msg = MSG; 


public String getMsg() { 
return msg; 
} 


public void setMsg(String msg) { 
this.msg = msg; 
} 


代码 解释 


这 里 配置 与 6.2.3 节 是 一 样 的 ， 是 类 型 安全 的 属性 获取 。 在 
application.properties 中 通过 hello.msg= 来 设置 ， 若 不 设置 ， 默 
认为 hello.msg=world。 


(3) 判断 依据 类 ， 代 人 码 如 下 : 





package com.wisely.spring_boot_starter_hello; 
public class HelloService { 
private String msg; 


public String sayHello(){ 
return "Hello" + msg; 
j 


public String getMsg() { 
return msg; 
} 


public void setMsg(String msg) { 
this.msg = msg; 
j 


代码 解释 


本 例 根据 此 类 的 存在 与 否 来 创建 这 个 类 的 Bean， 这 个 类 可 
以 是 第 三 方 类 库 的 类 。 


(4) 目 动 配置 类 ， 代 人 码 如 下 : 








package com.wisely.spring_boot_starter_hello; 


import 
import 
import 
import 
import 
import 
import 


org 


org. 
org. 
org. 


org 


org. 
org. 


.Springframework. 
springframework. 
springframework. 
springframework. 
.Springframework. 
springframework. 
springframework. 


QConfiguration 
QEnableConfigurationProperties(HelloServiceProperties.class) 
QConditionalOnClass(HelloService.class) 
@ConditionalOnProperty(prefix = "hello", value = "enabled", m 
public class HelloServiceAutoConfiguration ( 


QAutowired 
private HelloServiceProperties helloServiceProperties; 


QBean 
@ConditionalOnMissingBean(HelloService.class) 

public HelloService helloService(){ 

HelloService helloService = new HelloService(); 
helloService.setMsg(helloServiceProperties.getMsg()); 
return helloService; 


beans.factory.annotation.Autowired 
boot.autoconfigure.condition.Condi 
boot.autoconfigure.condition.Condi 
boot.autoconfigure.condition.Condi 
boot.context.properties.EnableConf 
context.annotation.Bean; 
context.annotation.Configuration; 


代码 解释 
根据 HelloServiceProperties 提 供 的 参数 ， 并 通过 


@ConditionalOnClass 判 断 HelloService 这 个 类 在 类 路 径 中 是 否 
存在 ， 且 当 容 器 中 没有 这 个 Bean 的 情况 下 自动 配置 这 个 Bean。 


(5) 注册 配置 。 在 6.5.1 中 我 们 知道 ， 奉 想 目 动 配置 生 
效 ， 需 要 注册 自动 配置 类 。 在 src/main/resources 下 新 建 META- 
INF/spring.factories， 结 构 如 图 6-12 所 示 。 


























wv i spring-boot-starter-hello 
E% src/main/Java 
($8 src/test/Java 


wv [5 src/main/resources 
wv (=> META-INF 


=) spring.factories 





图 6-12 ”结构 
在 Spring.factories 中 填写 如 下 内 容 注册 : 





org.springframework.boot.autoconfigure.EnableAutoConfiguratio 
com.wisely.spring boot starter hello.HelloServiceAutoConfigur 





行 有 多 个 目 动 配 置 ， 则 用 “，?” 隔 开 ， 此 处 光 是 为 了 换行 后 
仍然 能 读 到 属性 。 


另外 ， 大 在 此 例 新 建 的 项 目 中 无 sromain/resources 文 件 





夹 ， 需 执行 如 图 6-13 所 示 操 作 。 


;,US& E a eeoecete IF A2SEEEE 


Spring Starter Project 

Import Spring Getting Started Comert 
Spring Project 

Java Project 

Static Web Project 

Dynamic Web Project 

Maven Project 


f4 
Ame Shifte we 


Cri «c 


Civ 
Delete 


> 


Alte Shites > 
AlteShitteT + 


JUna Text Case 

Java Working Set 

Spring Bean Configuration File 
Spring Web Flow Defeition File 
Folder 

File 


Lipon. 

Refresh 

Close Project 

Close Urrelsted Projects 
Asegn Working Sets. 


^ 
-€ 


C. New Source Folder 


Source Folder 


Create a new source folder. 


Project name: | spring-boot-starter-hello 


Folder name: || src/main/resources 


|_| Update exclusion filters in other source folders to solve nesting 




















[ ]Ignore optional compile problems 





[6-13 ia] H src/maln/resources X- fF 3 


(5) 使 用 starter。 新 建 Spring Boot 项 目 ， 并 将 我 们 的 starter 
作为 依赖 ， 如 图 6-14 所 示 。 


New Spring Starter Project 


Type: 

Java Version: 
Boot Version: 
Group 
Artifact 
Version 
Description 


Package 


ch6_5 


Maven Project v Packaging: 


18 v Language: 
1.3.0 M1 

com.wisely 

ch6 5 

0.0.1-SNAPSHOT 


Demo project for Spring Boot 


com.wisely.ch6 5 


Dependencies 
[ ]AMQP 
AWS Messaging 


[ ]Batch 





Cloud Bus AMQP 


Config Server 
Eureka Server 
[ ]Gemfire 
]HSQLDB 
JDBC 
] LinkedIn 
[ ] Mustache 
]Redis 
[ ]Security 


Turbine AMQP 


| WS 















































AOP 


- JActuator 
[ ]Bitronix (TA) 


Cloud Connectors 


[ ]DevTools 
[ ]Facebook 
[ ] Groovy Templates 


Hystrix 


|_| JMS 

_| Mail 

C] MySQL 

[C] Remote Shell 
C] Solr 


Twitter 


AWS 
[C] Apache Derby 
[ ]Cache 
Cloud Security 
[ ]Elasticsearch 
Feign 
[]H2 
Hystrix Dashboard 
[]JPA 


C] Mobile 


OAuth2 





[C] Rest Repositories 
[| Thymeleaf 
Vaadin 


[ | Websocket 



































AWS JDBC 


[ ]Atomikos UTA) 


Cloud Bootstrap 
Config Client 


Eureka 


[ ]Freemarker 


HATEOAS 


- ]Integration 

| |Jersey UAX-RS) 
_|MongoDB 

[ ] PostgreSQL 


Ribbon 
Turbine 
Velocity 


Zuu 


图 6-14 ”新建 Spring Boot 项 目 


在 pom.xml 中 添加 spring-boot-starter-hello 的 依赖 ， 代 码 如 


<dependency> 


<groupId>com.wisely</groupId> 
<artifactId>spring-boot-starter-hello</artifactId> 
<version>0.0.1-SNAPSHOT</version> 


</dependency> 


我 们 可 以 在 Maven 的 依赖 里 查看 spring-boot-starter-hello， 


如 图 6-15 所 示 。 


v i spring-boot-starter-hello : 0.0.1-SNAPSHOT [cx 








à, ü00 | 


v (©) spring-boot-autoconfigure : 1.3.0.M1 [com; 
(3 spring-boot : 1.3.0.M1 (omitted for conf 


A snakeyaml : 1.15 (omitted for conflict wit 





图 6-15 #4 spring-Doot-starter-hello 


在 开发 阶段 ， 我 们 引入 的 依赖 是 spring-boot-starter-hello 这 
个 项 目 。 在 starter 稳 定之 后 ， 我 们 可 以 将 spring-boot-starter- 
hello 通 过 “mvn ”install* 安 装 到 本 地 库 ， 或 者 将 这 个 jar 包 发 布 到 


Maven 私 服 上 。 
简单 的 





运行 类 代码 如 下 : 


package com.wisely.ch6_5; 


import 
import 
import 
import 
import 


import 


org. 
org. 
org. 
org. 
.springframework.web.bind.annotation.RestController 


org 


com 


springframework.beans.factory.annotation.Autowired 
springframework.boot.SpringApplication; 

springframework.boot.autoconfigure.SpringBootAppli 
springframework.web.bind.annotation.RequestMapping 


.Wisely.spring boot starter hello.HelloService; 


QRestController 
QSpringBootApplication 
public class Ch65Application { 


@Autowired 
HelloService helloService; 


@RequestMapping("/") 
public String index(){ 
return helloService.sayHello(); 


} 


public static void main(String[] args) { 
SpringApplication.run(Ch65Application.class, args); 





在 代码 中 可 以 直接 注入 HelloService 的 Bean， 但 在 项 目 中 我 
们 并 没有 配置 这 个 Bean， 这 是 通过 自动 配置 完成 的 。 


访问 http://localhost: 8080， 效 果 如 图 6-16 所 示 。 





@ localhost:8080 x 


€ C | [5 localhost:8080 


Hello world 





图 6-16 访问 http://local host: 8080 


这 时 在 application.properties 中 配置 msg 的 内 容 : 


hello.msg 


= wangyunfei 


此 时 再 次 访问 http://localhost: 8080， 效 果 如 图 6-17 所 示 。 


@ localhost:8080 x 


€ 
Hello wangyunfei 


C | D localhost:8080 





图 6-17 ”查看 效果 
在 application.properties 中 添加 debug 属 性 ， 查 看 自动 配置 报 








=Æ., 
Fi e 


debug=true 








我 们 新 增 的 自动 配置 显示 在 控制 台 的 报告 中 ， 如 图 6-18 所 


7 o 





GenericCacheConfiguration 
- Automatic cache type (CacheCondition) 
ielloserviceAutoConfiguration | 
= MonditionalonClass classes found: com.wisely.spring boot starter hello.HelloService (OnClassCondition) 
matched (OnPropertyCondition) 
‘ion#helloService | 
(types: com.wisely.spring_boot_starter_hel SearchStrategy: all) found no beans (OnBeanCondition) 








lo.HelloService; 













[elloserviceAutoco 
- @Conditionalor 





ies found: org.springframework.web.filter.CharacterEncodingFilter (OnClassCondition) 
jeans (OnBeanCondition) 


cterEncodingFilter 
es: org. springframework.web.filter.CharacterEncodingFilter; SearchStrategy: all) found no 


chara 
n (typ: 








图 6-18 ”控制 台 报 告 


387% Spring Boot 的 Web 开 发 


Web 开 发 是 开发 中 至 关 重 要 的 一 部 分 ，Web 开 及 的 核心 内 
容 主要 包括 内 骸 Servlet 容 器 和 Spring MVC. 


7.1 Spring Boot 的 Web 开 发 支持 


Spring Boot 提 供 了 spring-boot-starter-web 为 Web 开 发 予以 支 
WF. spring-boot-starter-web Ask Fett T te AH Tomcat EJ & 
Spring MVC 的 依赖 。 而 Web 相关 的 自动 配置 存储 在 spring-boot- 
autoconfigure.jar 的 org.Springframework.boot.autoconfigure.web 


下 ， 如 图 7-1 所 示 。 


£8 web 
^ $h BasicErrorController.class 
> t DefaultErrorAttributes.class 
; $h DispatcherServletAutoConfiguration.class 

th EmbeddedServletContainerAutoConfiguration.class 
^ d ErrorAttributes.class 

In ErrorController.class 
» 1» ErrorMvcAutoConfiguration.class 


> $ GsonHttpMessageConvertersConfiguration.class 
; Èh GzipFilterAutoConfiguration.class 

» ih GzipFilterProperties.class 

» 48 HttpEncodingAutoConfiguration.class 


> 48 HttpEncodingProperties.class 

ta HttpMessageConverters.class 

is HttpMessageConvertersAutoConfiguration.class 
$ JacksonHttpMessageConvertersConfiguration.class 

» d» JspTemplateAvailabilityProvider.class 
$S MultipartAutoConfiguration.class 

; 18 MultipartProperties.class 

^ $h ResourceProperties.class 

; $ ServerProperties.class 

^ dy ServerPropertiesAutoConfiguration.class 

> 1» WebMvcAutoConfiguration.class 

; 1 WebMvcProperties.class 





图 7-1 Web 相 关 的 自动 配置 
从 这 些 文件 名 可 以 看 出 : 


e ServerPropertiesAutoConfiguration 和 ServerProperties 目 动 配 
置 内 舰 Servlet 容 峰 ; 

。 HttpEncodingAutoConfiguration 和 HttpEncodingProperties 用 
来 自动 配置 http 的 编码 ; 

e MultipartAutoConfiguration 和 MultipartProperties 用 来 自动 配 


置 上 传 文件 的 属性 ; 

e JacksonHttpMessageConvertersConfiguration 用 来 自动 配置 
mappingJackson2Http MessageConverter 利 
mappingJackson2XmlHttpMessage Converter; 

。WebMvcAutoConfiguration 和 WebMvcProperties 配 置 Spring 
MVC. 


7.2 Thymeleaff fi 5| S& 











本 书 前 面 的 内 容 很 少 用 到 页 面 模板 引擎 相关 的 内 容 ， 介 和 尔 
使 用 了 JSP 页 面 ， 但 是 尽 可 能 少 地 涉及 JSP 相 关 知 识 ， 这 是 因为 
JSP 在 内 骨 的 Servlet 的 容器 上 运行 有 一 些 问题 (内 骨 Tomcat、 
Jetty 不 支持 以 jar 形 式 运 行 JSP，Undertow 不 支持 JSP) 。 











Spring ^ Boot 提供 了 大 量 模板 引擎 ， 包 含 括 FreeMarker、 
Groovy、Thymeleaf、Velocity 和 Mustache，Spring Boot 中 推荐 
使 用 Thymeleaf 作 为 模板 引擎 ， 因 为 Thymeleaf 提 供 了 完美 的 
Spring MVC 的 支持 。 


7.2.1 Thymeleaf 基 础 知识 





Thymeleaf 是 一 个 Java 类 库 ， 它 是 一 个 xml/xhtmljhtml5 的 模 
板 引 擎 ， 可 以 作为 MVC 的 Web 应 用 的 View 层 。 


Thymeleaf 还 提供 了 额外 的 模块 与 Spring MVC4ERK, ATLL 
我 们 可 以 使 用 Thymeleaf 完 全 替代 JSP。 


下 面 我 们 演示 日 常 工作 中 常用 的 Thymeleaf 用 法 ， 我 们 将 把 
本 节 的 内 容 在 7.2.4 节 运行 演示 。 

1.5| AThymeleaf 

下 面 的 代码 是 一 个 基本 的 Thymeleaf 模 板 页 面 ， 在 这 里 我 们 


引入 了 Bootstrap〈 作 为 样式 控制 ) 和 jQuery (DOM 操 作 ) , 4 
然 它 们 不 是 必需 的 : 


«html xmins:th="http://www.thymeleaf.org"><!-- 1 --> 
<head> 
<meta content="text/html; charset=UTF-8"/> 
«link th:src="@{bootstrap/css/bootstrap.min.css}" rel="st 


- 2 --> 
<link th:src="@{bootstrap/css/bootstrap- 
theme.min.css}" rel="stylesheet"/><!-- 2 --> 
</head> 
<body> 
<script th:src="@{jquery- 
1.10.2.min.js}" type="text/javascript"></script><!-- 2 --> 
<script th:src="@{bootstrap/js/bootstrap.min.js}"> 
</script><!-- 2 --> 
</body> 
</html> 
代码 解释 


QD 通过 xmlns: th=http://www.thymeleaf.org 命 名 空间 ， 将 镜 
头 页 面 转换 为 动态 的 视图 。 需 要 进行 动态 处 理 的 元 素 将 使 
用 “th: ”为 前 级 ; 


GO 通过 “@{1}2 引 用 Web 静 态 资源 ， 这 在 JSP 下 是 极 易 出 错 
的 。 


2. 访 问 model 中 的 数据 
通过 “${} ?访问 model 中 的 属性 ， 这 和 JSP 极 为 相似 。 


<div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class="panel-title">ij ļmodel</h3> 
</div> 
<div class="panel-body"> 
<span th: text="${singlePerson.name}"></span> 
</div> 
</div> 


代码 解释 


使 用 <span th: text="${singlePerson.name}"></span> 访 问 
model 中 的 singlePerson 的 name 属 性 。 注 意 : 需要 处 理 的 动态 内 
容 需 要 加 上 “th: "BEAR. 


3.model 中 的 数据 迭代 
Thymeleaf 的 迭代 和 JSP 的 写法 也 很 相似 ， 代 人 码 如 下 : 


<div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class="panel-title">%I]#</h3> 
</div> 
<div class="panel-body"> 
«ul class="list-group"> 
<li class="list-group- 
item" th:each="person:${people}"> 
<span th:text="${person.name}"></span> 
<span th:text="${person.age}"></span> 
</li> 
</ul> 
</div> 
</div> 


代码 解释 


使 用 由 : each 来 做 循环 迭代 Cth: each="person: 
${people}") , personfEZJXATX JG ZR OK BE HA, AJ f E TRI — E 
访问 迭代 元 素 中 的 属性 。 


4. 数 据 判断 
代码 如 下 : 


<div th:if="${not #lists.isEmpty(people)}"> 


<div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class="panel-title">%#</h3> 
</div> 
<div class="panel-body"> 
<ul class="list-group"> 
«li class="list-group- 
item" th:each="person:${people}"> 
<span th: text="${person.name}"></span> 
<span th:text="${person.age}"></span> 
</li> 
</ul> 
</div> 
</div> 
</div> 


代码 解释 


通过 ${not#lists.isEmpty (people) } 表 达 式 判断 people 是 人 否 
A. Thymeleafsc##>. <, >=, «---. ! = 作为 比较 条 件 ， 
同时 也 支持 将 SpringEL 表 达 式 语言 用 于 条 件 中 。 


5. 在 JavaScript 中 访问 model 


在 项 目 中 ， 我 们 经 常 需 要 在 JavaScript 访 问 model 中 的 值 ， 
在 Thymeleaf 里 实现 代码 如 下 : 








<script th:inline="javascript"> 
var single = [[${singlePerson}]]; 
console. log(single.namet+"/"+single.age) 
</script> 


代码 解释 


。 通 过 th: inline=“javascript” 添 加 到 script 标 签 ， 这 样 





JavaScript 代 人 码 即 可 访问 model 中 的 属性 ; 
通过 “[[${}]]* 格 式 获得 实际 的 值 。 


还 有 一 种 是 需要 在 html 的 代码 里 访问 model 中 的 属性 ， 例 
如 ， 我 们 需要 在 列表 后 单 击 每 一 行 后 面 的 按钮 获得 model 中 的 
值 ， 可 做 如 下 处 理 : 








«li class="list-group-item" th:each="person:${people}"> 

<span th:text="${person.name}"></span> 

«span th:text="${person.age}"></span> 

«button class="btn" th:onclick="'getName(\'' + ${person.na 
获得 名 字 </button> 
</1i> 


代码 解释 


onclick="'getName (\"+${person.name}+\) ; "o 


6. 其 他 知识 


更 多 更 完整 的 Thymeleaf 的 知识 ， 请 查看 
http://www.thymeleaf.org 的 官网 。 





7.2.2 ”与 Spring MVC 集 成 


在 Spring MVC 中 ， 寿 我 们 需要 集成 一 个 模板 引 警 的话， 需 
要 定义 ViewResolver， 而 ViewResolver 需 要 定义 一 个 View， 如 
4.2.2 节 中 我 们 为 JSP 定 义 的 ViewResolver 的 代码 : 


@Bean 
public InternalResourceViewResolver viewResolver(){ 


InternalResourceViewResolver viewResolver = new Inter 
viewResolver.setPrefix("/WEB-INF/classes/views/"); 
viewResolver.setSuffix(".jsp"); 
viewResolver.setViewClass(JstlView.class); 

return viewResolver; 


通过 上 面 的 代码 可 以 看 出 ， 使 用 JsltView 定 义 了 一 个 
InternalResourceViewResolver， 因 而 使 用 Thymeleaf 作 为 我 们 的 
模板 引擎 也 应 该 做 类 似 的 定义 。 庆 幸 的 是 ，Thymeleaf 为 我 们 
定义 好 了 org.thymeleaf.spring4.view.ThymeleafView 和 
org.thymeleaf.spring4.view.ThymeleafViewResolver (默认 使 用 
ThymeleafView 作 为 View) 。Thymeleaf 给 我 们 提供 了 一 个 
SpringTemplateEngine 类 ， 用 来 驱动 在 Spring MVC 下 使 用 
Thymeleaf 模 板 引 擎 ， 男 外 还 提供 了 一 个 TemplateResolver 用 来 
设置 通用 的 模板 引 苟 (包含 前 级 、 后 级 等 ， 这 使 我 们 在 
Spring MVC 中 集成 Thymeleaf 引 苟 变 得 十 分 简单 ， 代 人 码 如 下 : 








@Bean 

public TemplateResolver templateResolver(){ 
TemplateResolver templateResolver = new ServletContextTem 
templateResolver.setPrefix("/WEB-INF/templates"); 
templateResolver.setSuffix(".html"); 
templateResolver.setTemplateMode("HTML5"); 

return templateResolver; 


j 


QBean 

public SpringTemplateEngine templateEngine(){ 
SpringTemplateEngine templateEngine - new SpringTemplateE 
templateEngine.setTemplateResolver(templateResolver()); 
return templateEngine; 


j 


QBean 

public ThymeleafViewResolver thymeleafViewResolver()( 
ThymeleafViewResolver thymeleafViewResolver - new Thymele 
thymeleafViewResolver.setTemplateEngine(templateEngine()) 


// thymeleafViewResolver.setViewClass(ThymeleafView.cla 
return thymeleafViewResolver; 


7.2.8 Spring Boot Thymeleaf x: t$ 


在 上 一 节 我 们 讲述 了 Thymeleaf 与 Spring MVC 集 成 的 配 
置 ， 讲 述 的 目的 是 为 了 方便 大 家 理解 Spring MVC 和 Thymeleaf 
集成 的 原理 。 但 在 Spring Boot 中 这 一 切 都 是 不 需要 的 ，Spring 
Boot 通 过 org.springframework.boot.autoconfigure.thymeleaf 包 对 


Thymeleaf 进 行 了 目 动 配置 ， 如 图 7-2 所 示 。 


H3 thymeleaf 
ba ThymeleafAutoConfiguration.class 








bs ThymeleafProperties.class 





‘nh ThymeleafTemplateAvailabilityProvider.class 
图 7-2 ”thymeleaf 包 


通过 ThymeleafAutoConfiguration 类 对 集成 所 需要 的 Bean 进 
行 自 动 配置 ， 包 括 templateResolver、templateEngine 和 
thymeleafViewResolver 的 配置 。 


通过 ThymeleafProperties 来 配置 Thymeleaf， 在 
application.properties 中 ， 以 spring.thymeleaf 开 头 来 配置 ， 通 过 
查看 ThymeleafProperties 的 主要 源码 ， 我 们 可 以 看 出 如 何 设置 
属性 以 及 默认 配置 : 


QConfigurationProperties("spring.thymeleaf") 
public class ThymeleafProperties { 


public static final String DEFAULT PREFIX - "classpath:/t 


public static final String DEFAULT SUFFIX = ".html"; 





P dus 
*HAKE, Spring Boot 默 认 模 板 ， 防 止 在 
classpath:/templates/ 目录 下 
i 4 


private String prefix - DEFAULT PREFIX; 


/** 
* 后 级 设置 ， 默 认为 html 
d d 


private String suffix - DEFAULT SUFFIX; 





/** 


* 模板 模式 设置 ， 默 认为 HTML 5 
*/ 





private String mode = "HTML5"; 


** 


* 模板 的 编码 设置 ， 默 认为 UTF-8 
*/ 





private String encoding = "UTF-8"; 


/** 


* 模板 的 媒体 类 型 设置 ， 默 认为 text/html. 
*/ 





private String contentType = "text/html"; 


/** 

* 是 否 开启 模板 缓存 ， 默 认 是 开启 ， 开 发 时 请 关闭 
private boolean cache = true; 

Zu 





7.2.4 KË 


1.39 f& Spring Boot 项 目 
选择 Thymeleaf 依 赖 ，spring-boot-starter-thymeleaf 会 自动 包 


含 Spring-boot-starter-web， 如 图 7-3 所 示 。 


eo 


Maven Project ~ 
18 v 


1.3.0 M1 


com.wisely 
ch7 2 
0.0.1. SNAPSHOT 
Description Demo project for Spring Boot 
Package com.wisely 
Dependencies 
|AMQP AOP AWS 
AWS Messaging |) Actuator [] Apache Derby 
Batch Bitronix (TA) | ] Cache 
oud Bus AMQP [C] Cloud Connectors Cloud Security 
Config Serve DevTools Elasticsearch 
Eureka Serv 口 Facebook 
|Gemfire Groovy Templates | 
CJ HSQLOR 
| JDBC 
口 Unkedin 
|Mustache - 2 
Redis a sitories 
Security | 


[ ]Atomikos (ITA) 


3 Bootstrap 


[ Freemarker 


| HATEOAS 


| [Integration 


Jersey UAX-RS) 
[ ]MongoD8 
|PostgreSQL 
Ribbor 


bire 


O Velocity 





图 7-3 ”新 建 Spring Boot™ H 


2. 示 例 JavaBean 








此 类 用 来 在 模板 页 面 展示 数据 用 ， 包 含 name 属 性 和 age 属 


PE: 


package com.wisely; 


public class Person { 
private String name; 
private Integer age; 


public Person() { 
super(); 


public Person(String name, Integer age) { 
super () 
this.name = name; 
this.age = age; 


j 
public String getName() { 
return name; 


public void setName(String name) ( 
this.name - name; 


j 
public Integer getAge() { 
return age; 


} 

public void setAge(Integer age) { 
this.age = age; 

} 





3. 脚 本 样式 静态 文件 


根据 默认 原则 ， 脚 本 样式 、 图 片 等 静态 文件 应 放置 在 
src/main/resources/static 下 ， 这 里 引入 了 Bootstrap 和 jQuery， 结 


构 如 图 7-4 所 示 。 


E src/main/resources 
v [ static 


© bootstrap 
jquery-1.10.2.min,js 





Kl7-A 文件 位 置 
4. 演 示 页 面 


根据 默认 原则 ， 页 面 应 放置 在 src/main/resources/templates 





Fo fEsrc/main/resources/templates F 3/r£&index.html, "7-5 
所 示 。 


src/main/resources 
(= static 


v © templates 
index.html 





图 7-5 ”新建 imdex.html 
代码 如 下 : 


«html xmins:th="http://www.thymeleaf.org"> 
<head> 
<meta content="text/html; charset=UTF-8"/> 
<meta http-equiv="X-UA-Compatible" content="IE=edge"/> 
«meta name="viewport" content="width=device- 
width, initial-scale=1"/> 
<link th:href="@{bootstrap/css/bootstrap.min.css}" rel="s 


<link th: href="@{bootstrap/css/bootstrap- 
theme.min.css)" rel="stylesheet"/> 
</head> 
<body> 


<div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class="panel-title"> 访 问 model</h3> 
</div> 
<div class="panel-body"> 
<span th:text="${singlePerson.name}"></span> 
</div> 
</div> 


<div th:if="${not #lists.isEmpty(people)}"> 
<div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class="panel-title">%I|#</h3> 
</div> 
<div class="panel-body"> 


<ul class="list-group"> 
«li class="list-group- 
item" th:each="person:${people}"> 
<span th:text="${person.name}"></span> 
<span th:text="${person.age}"></span> 
<button class="btn" th:onclick="'getName(\ 
获得 名 字 </button> 
</li> 
</ul> 
</div> 
</div> 
</div> 


<script th:src="@{jquery- 
1.10.2.min.js}" type="text/javascript"></script><!-- 2 --> 
<script th:src="@{bootstrap/js/bootstrap.min.js}"> 
</script><!-- 2 --> 


<script th:inline="javascript"> 
var single = [[${singlePerson}]]; 
console. log(single.namet+"/"+single.age) 


function getName(name) { 
console. log(name) ; 


</script> 


</body> 
</html> 


5. 数 据 准 备 
代码 如 下 : 


package com.wisely; 


import java.util.ArrayList; 
import java.util.List; 


import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootAppli 
import org.springframework.stereotype.Controller; 

import org.springframework.ui.Model; 


import org.springframework.web.bind.annotation.RequestMapping 
@Controller 

@SpringBootApplication 

public class Ch72Application { 


@RequestMapping("/") 
public String index(Model model) { 
Person single = new Person("aa",11); 


List<Person> people = new ArrayList<Person>(); 


Person p1 = new Person("xx",11); 
Person p2 - new Person("yy",22); 
Person p3 - new Person("zz",33); 


people.add(p1); 
people.add(p2); 
people.add(p3); 


model.addAttribute("singlePerson", single); 
model.addAttribute("people", people); 


return "index"; 


j 


public static void main(String[] args) { 
SpringApplication.run(Ch72Application.class, args); 


63517 
访问 http://localhost: 8080， 效 果 如 图 7-6 所 示 。 
单 击 “* 获 得 名 字 ? 选 项 ， 效 果 如 图 7-7 所 示 。 


€ > C 55 localhost:8080 


35 |n]model 


Q [] Elements Network Sources » = € Ox 


G Y <topframe> v © Preserve log 


> 





图 7-6 ”访问 http://localhost: 8080 


G Ww <topframe> v © Preserve log 


3a/11 (index):52 
(index):55 
(index):55 
(index):55 





图 7-7 单 击 获得 名 字 


7.3 “Web 相关 配置 


7.3.1 Spring Boot 提 供 的 目 动 配置 


通过 查看 WebMvcAutoConfiguration 及 WebMvcProperties 的 
源码 ， 可 以 发 现 Spring Boot 为 我 们 提供 了 如 下 的 自动 配置 。 


1. 自 动 配置 的 ViewResolver 





(1) ContentNegotiatingViewResolver 


这 是 Spring MVC 提 供 的 一 个 特殊 的 ViewResolver， 
ContentNegotiatingViewResolver 不 是 自己 处 理 View， 而 是 代理 
给 不 同 的 ViewResolver 来 处 理 不 同 的 View， 所 以 它 有 最 高 的 优 
先 级 o 


(2) BeanNameViewResolver 


Ertl CQ Controller) 中 的 一 个 方法 的 返回 值 的 字符 串 
(视图 名 ) 会 根据 BeanNameViewResolver 去 查找 Bean 的 名 称 
为 返回 字符 串 的 View 来 泻 染 视图 。 是 不 是 不 好 理解 ， 下 面 举 
^P MBI-T s 


^E X BeanNameViewResolverl] Bean: 








QBean 
public BeanNameViewResolver beanNameViewResolver() { 
BeanNameViewResolver resolver - new BeanNameViewR 
return resolver; 


} 


定义 一 个 View 的 Bean， 名 称 为 jsonView: 


@Bean 
public MappingJackson2JsonView jsonView(){ 
MappingJackson2JsonView jsonView = new MappingJackson 


return jsonView; 


在 控制 器 中 ， 返 回 值 为 字符 串 jsonView， 它 会 找 Bean 的 名 
称 为 jsonView 的 视图 来 泻 染 : 


@RequestMapping(value = "/json", produces= 
{MediaType .APPLICATION_JSON _VALUE}) 
public String json(Model model) { 
Person single = new Person("aa",11); 
model.addAttribute("single", single); 
return "jsonView"; 


(3) InternalResourceViewResolver 
这 个 是 一 个 极为 常用 的 ViewResolver， 主 要 通过 设置 前 
级 、 后 级 ， 以 及 控制 融 中 方法 来 返回 视图 名 的 字符 串 ， 以 得 到 
实际 页 面 ，Spring Boot 的 源码 如 下 : 





@Bean 
QConditionalOnMissingBean(InternalResourceViewResolve 
public InternalResourceViewResolver defaultViewResolv 
InternalResourceViewResolver resolver - new Inter 
resolver.setPrefix(this.prefix); 
resolver.setSuffix(this.suffix); 
return resolver; 


2. 目 动 配置 的 静态 资源 


在 自动 配置 类 的 addResourceHandlers 方 法 中 定义 了 以 下 静 
态 资源 的 自动 配置 。 
(1) 类 路 径 文 件 
把 类 路 径 下 的 /static、/public、/resources 和 /META- 


INF/resources 文 件 夹 下 的 静态 文件 直接 映射 为 /**， 可 以 通过 
http://localhost: 8080/** 来 访问 。 








(2) webjar 


何谓 webjar，webjar 束 是 将 我 们 常用 的 脚本 框架 封装 在 jar 
包 中 的 jar 包 ， 更 多 关于 webjar 的 内 容 请 访问 


http://www. webjars.org)4| yj © 


把 webjar 的 /META- a es ote, ars/ 下 的 静态 文件 映 
射 为 /webjar/**， 可 以 通过 http://localhost: 8080/webjar/** 来 访 
问 。 


3. 自 动 配置 的 Formatter 和 Converter 


关于 自动 配置 Formatter 和 Converter， 我 们 可 以 看 一 下 
WebMvcAutoConfiguration 类 中 的 定义 : 





@Override 


public void addFormatters(FormatterRegistry registry) 


for (Converter<?, 
> converter : getBeansOfType(Converter.class)){ 
registry.addConverter(converter); 


? 


for (GenericConverter converter : getBeansOfType( 


registry.addConverter(converter); 


for (Formatter<? 
> formatter : getBeansOfType(Formatter.class)) { 
registry.addFormatter(formatter); 


j 


private «T» Collection<T> getBeansOfType(Class<T> typ 
return this.beanFactory.getBeansOfType(type).valu 
} 


从 代码 中 可 以 看 出 ， 只 要 我 们 定义 了 Converter、 
GenericConverter 和 Formatter 接 口 的 实现 类 的 Bean， 这 些 Bean 
束 会 自动 注册 到 Spring MVC 中 。 


4. 自 动 配置 的 HttpMessageConverters 


在 WebMvcAutoConfiguration 中 ， 我 们 注册 了 
messageConverters， 代 码 如 下 ; 


@Autowired 
private HttpMessageConverters messageConverters; 


QOverride 
public void configureMessageConverters(List«HttpMessa 
>> converters) { 
converters.addAll(this.messageConverters.getConve 
} 


在 这 里 直接 注入 了 HttpMessageConverters 的 Bean， 而 这 个 
Bean 是 在 HttpMessageConvertersAutoConfiguration 类 中 定义 
的 ， 我 们 自动 注册 的 HttpMessage Converter f Spring MVCEK 
认 的 ByteArrayHttpMessageConverter、StringHttpMessage 
Converter、 Resource HttpMessageConverter, 
SourceHttpMessageConverter, AllEncompassing 
FormHttpMessageConverter 外 ， 在 我 们 的 HttpMessageConverters 


AutoConfiguration 的 目 动 配置 文件 里 还 引入 了 
JacksonHttpMessageConverters Configuration 和 GsonHttpMessage 


ConverterConfiguration， 使 我 们 获得 了 额外 的 


HttpMessageConverter: 
。 各 jackson 的 jar 包 在 类 路 径 上 ， 则 Spring Boot 通 过 
JacksonHttpMessage Converters Configuration? JH 


MappingJackson2HttpMessage Converter#!l Mapping Jackson2 
XmlHttpMessageConverter; 


e 各 gson 的 jar 包 在 类 路 径 上 ， 则 Spring Boot 通 过 
GsonHttpMessageConverter Configuration? JH 
GsonHttpMessageConverter. 

在 Spring Boot 中 ， 如 果 要 新 增 自 定 义 的 


HttpMessageConverter， 则 只 需 定义 一 个 你 自己 的 
HttpMessageConverters 的 Bean， 然 后 在 此 Bean 中 注册 自 定义 
HttpMessageConverter 妈 可， 例如 : 


@Bean 
public HttpMessageConverters customConverters() { 
Ht tpMessageConverter<? 
> customConverteri- new CustomConverter1(); 
HttpMessageConverter«? 
» customConverter2- new CustomConverter2(); 
return new HttpMessageConverters(customConverteri1, cu 


5. 静 态 首 页 的 支持 
把 静态 index.html 文 件 放 置 在 如 下 目录 。 


e classpath: /META-INF/resources/index.html 


e classpath: /resources/index.html 
e classpath: /static/index.html 
e classpath: /public/index.html 


当 我 们 访问 应 用 根 目 录 http://localhost: 8080/ 时 ， 会 直接 映 





射 
7.8.2 ”接管 Spring Boot 的 Web 配 置 


如 果 Spring Boot 提 供 的 Spring MVC 不 符合 要 求 ， 则 可 以 通 
过 一 个 配置 类 (注解 有 @Configuration 的 类 ) 加 上 
@EnableWebMvc 注 解 来 实现 完全 自己 控制 的 MVC 配 置 。 


当然 ， 通 常情 况 下 ，Spring Boot 的 自动 配置 是 符合 我 们 大 
多 数 需求 的 。 在 你 既 需 要 保留 Spring Boot 提 供 的 便利 ， 叉 需要 
增加 自己 的 额外 的 配置 的 时 候 ， 可 以 定义 一 个 配置 类 并 继承 
WebMvcConfigurerAdapter， 无 须 使 用 @EnableWebMvc 注 解 ， 
然后 按照 第 4 章 讲 解 的 Spring MVC 的 配置 方法 来 添加 Spring 
Boot 为 我 们 所 做 的 其 他 配置 ， 例 如 : 





@Configuration 
public class WebMvcConfig extends WebMvcConfigurerAdapter { 
@Override 
public void addViewControllers(ViewControllerRegistry 
registry.addViewController("/xx").setViewName("/xx 
} 





值得 指出 的 是 ， 在 这 里 重 写 的 addViewControllers 方 法 ， 并 
不 会 覆盖 WebMvcAutoConfiguration 中 的 
addViewControllers〈 在 此 方法 中 ，Spring Boot 将 “/” 映 射 至 





index.html) ， 这 也 就 意味 着 我 们 目 己 的 配置 和 Spring Boot 的 
自动 配置 同时 有 效 ， 这 也 是 我 们 推荐 添加 上 自己 的 MVC 配 置 的 





7.3.3 注册 Servlet、FEilter、Listener 





当 使 用 髓 入 式 的 Servlet 容 器 (Tomcat, Jetty) 时 ， 我 们 
通过 将 Servlet、Filter 和 Listener 声 明 为 Spring “Bean 而 达到 注册 
的 效果 ; 或 者 注册 ServletRegistrationBean、 
FilterRegistrationBean 和 ServletListenerRegistrationBean 的 
Bean. 


(1) 直接 注册 Bean 示 例 ， 代 码 如 下 : 


@Bean 
public XxServlet xxServlet (){ 
return new XxServlet() 


, 


QBean 

public YyFilter yyFilter (){ 
return new YyFilter(); 

} 


@Bean 
public ZzListener zzListener (){ 
return new ZzListener(); 


(2) 通过 RegistrationBean 示 例 : 


@Bean 
public ServletRegistrationBean servletRegistrationBean() 


return new ServletRegistrationBean(new XxServlet(),"/ 


{ 


} 
@Bean 


public FilterRegistrationBean filterRegistrationBean(){ 
FilterRegistrationBean registrationBean = new FilterR 
registrationBean.setFilter( new YyFilter()); 
registrationBean.setOrder(2); 
return registrationBean; 


j 


QBean 
public ServletListenerRegistrationBean<ZzListener> zzList 


return new ServletListenerRegistrationBean<ZzListener 


(new ZzListener()); 


j 


7.4 Tomcat 配 置 


本 节 昌 然 叫 Tomcat 配 置 ， 但 其 实 指 的 是 servlet 容 器 的 配 
置 ， 因 为 Spring uui 内 骨 的 Tomcat 为 servlet 容 器 ， 所 以 本 
节 只 讲 对 Tomcat 配 置 ， 其 实 本 市 的 配置 对 Tomcat、Jetty 和 
Undertow 都 是 通用 的 。 











7.4.1 配置 Tomcat 


关于 Tomcat 的 所 有 属性 都 在 
org.springframework.boot. t.autoconfigure. web. ServerPropertiesft Ei 
类 中 做 了 定义 ， 我 们 只 需 在 application. properties 配 置 属 
置 即 可 。 通 用 的 Servlet 容 器 配置 都 以 “server" 作 为 前 组 ， 
Tomcat 特 有 配置 都 以 “server.tomcat* 作 为 前 级 。 下 面 举 一 m 
用 的 例子 。 


配置 Servlet 容 器 : 





server.port- # 配 置 程序 端口 ， 默 认为 8080 
server.session-timeout= # 用 户 会 话 sSession 过 期 时 间 ， 以 秒 为 单位 
server.context-path= # 配 置 访问 路 径 ， 默 认为 / 





配置 Tomcat: 





server.tomcat.uri-encoding = # 配 置 Tomcat 编 码 ， 默 认为 UTF-8 
server.tomcat.compression- # Tomcat 是 否 开启 压缩 ， 默 认为 关闭 off 











更 为 详细 的 a ， 请 查看 附录 A 
中 以 “server” 





ll*server.tomcat" Yy Al AX AY FO Bi. « 


7.4.2 AREMA Tomcat 


如 果 你 需 


要 通过 代码 的 方式 配置 servlet 容 器 ， 则 可 以 注册 


一 个 实现 EmbeddedServletContainerCustomizer 接 口 的 Bean; 4 
想 直接 配置 Tomcat、Jetty、Undertow， 则 可 以 直接 定 定义 
TomcatEmbeddedServletContainerFactory、 
JettyEmbeddedServletContainer Factory, 
UndertowEmbeddedServletContainerFactory - 


通用 配置 
C1) JER M E: 





package com.wisely.ch7_4; 


import 


import 
import 
import 
import 
import 


java.util.concurrent.TimeUnit; 


org. 
.springframework.boot.context.embedded.EmbeddedServ 


org 


org. 
org. 
org. 


@Component 
public class CustomServletContainer implements EmbeddedServle 


springframework.boot.context.embedded.Configurable 


springframework.boot.context.embedded.ErrorPage; 
springframework.http.HttpStatus; 
springframework.stereotype.Component; 


QOverride 

public void customize(ConfigurableEmbeddedServletContaine 
container.setPort(8888); //1 
container.addErrorPages(new ErrorPage(HttpStatus.NOT 
container.setSessionTimeout(10,TimeUnit.MINUTES); //3 





(2) 当前 配置 文件 内 配置 。 知 要 在 当前 已 有 的 配置 文件 
AA 则 在 Spring 配置 中 ， 注 意 当 前 类 要 声明 
/jJstatic: 








QSpringBootApplication 
public class Ch74Application { 


public static void main(String[] args) { 
SpringApplication.run(Ch74Application.class, args); 


@Component 
public static class CustomServletContainer implements Emb 


@Override 

public void customize(ConfigurableEmbeddedServletCont 
container .setPort(8888); //1 
container .addErrorPages(new ErrorPage(HttpStatus. 
container .setSessionTimeout(10, TimeUnit .MINUTES) ; 


2. 特 定 配置 


下 面 以 Tomcat 为 例 〈Jetty 使 用 
JettyEmbeddedServletContainerFactory，Undertow 使 用 
UndertowEmbeddedServletContainerFactory ) 


@Bean 
public EmbeddedServletContainerFactory servletContainer ( ) 
TomcatEmbeddedServletContainerFactory factory = new Tomca 

factory.setPort(8888); //1 

factory.addErrorPages(new ErrorPage(HttpStatus.NOT FOUND, "/4 
factory.setSessionTimeout(10, TimeUnit.MINUTES); //3 
return factory; 


代码 解释 
上 面 两 个 例子 的 代码 都 实现 了 这 些 功 能 : 
OME mH; 


@ 配 置 错误 页 面 ， 根 据 HttpStatus 中 的 错误 状态 信息 ， 直 接 
转 癌 错误 页 面 ， 其 中 404.html] 放 置 在 srcmain/resources/static 下 
BD nj; 


G@) 配 置 Servlet 容 器 用 户 会 话 (session) 过 期 时 间 。 





7.4.3 ”和 蔡 换 Tomcat 


Spring —— BootzA iA fi Hj TomcatfE AW ikServletAas, BA 
spring-boot-starter-web 依 赖 ， 如 图 7-8 所 示 。 





(3 spring-boot-starter-web : 1.3.0.M1 [compile] 
G spring-boot-starter : 1.3.0.M1 (omitted for conflict with 
v 0 spring-boot-starter-tomcat : 1.3.0.M1 [compile] 
癌 tomcat-embed-core : 8.0.23 [compile] 
(3 tomcat-embed-el : 8.0.23 [compile] 
( tomcat-embed-logging-juli : 8.0.23 [compile] 


e 
v | 


| tomcat-embed-websocket : 8.0.23 [compile] 
Q tomcat-embed-core : 8.0.23 (omitted for conflict | 











图 7-8 #4 Spring-boot-starter-web fK Xf 


如 果 要 使 用 Jetty 或 者 Undertow 为 sevvlet 容 器 ， 只 需 修改 
spring-boot-starter-web 的 依赖 即 可 。 


1.8 18 AJetty 
在 pom.xml 中 ， 将 spring-boot-starter-web 的 依赖 由 spring- 


boot-starter-tomcat # fk Aspring-boot-starter-Jetty: 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
web</artifactId> 
<exclusions> 
<exclusion> 
«groupId»org.springframework.boot«/groupI 
<artifactId>spring-boot-starter - 
tomcat</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter- 
jetty</artifactId> 
</dependency> 


此 时 启动 Spring Boot， 控 制 台 输出 效果 如 图 7-9 所 示 。 


Started ServerConnector@1@6cb@8{HTTP/1.1}{@.0.0.0:8030} 


prune on port(s) 8080 (http/1.1) 
arted Ch72Application in 4.077 seconds (JVM running for 4.408) 














图 7-9 ”控制 合 输出 效果 
2. #4 ff. "y Undertow 


在 pom.xml 中 ， 将 spring-boot-starter-web 的 依赖 由 spring- 
boot-starter-tomcat Ë # 7Jspring-boot-starter-undertow: 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
web</artifactId> 
<exclusions> 
<exclusion> 
«groupId»org.springframework.boot«/groupI 


<artifactId>spring-boot-starter- 
tomcat</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
undertow</artifactId> 
</dependency> 


此 时 启动 Spring Boot， 控 制 台 输出 效果 如 图 7-10 所 示 。 


Undertow |started on port(s) 8080 (http) 


Started Ch72Application in 2.26 seconds (JVM running for 2.578) 


图 7-10 ”控制 合 输出 效果 














7.4.4 SSL 配 置 





SSL 的 配置 也 是 我 们 在 实际 应 用 中 经 常 过 到 的 场景 。 


SSL (Secure Sockets Layer, ZEEE) 是 为 网 络 通信 提 
供 安全 及 数据 完整 性 的 一 种 安全 协议 ，SSL 在 网 络 传输 层 对 网 
络 连接 进行 加 密 。SSL 协 议 位 于 TCP/AP 协 议 与 各 种 应 用 层 协议 
之 间 ， 为 数据 通信 提供 安全 文 持 。SSL 协 议 可 分 为 两 层 : SSL 
记录 协议 CSSL Record Protocol) ， 它 建立 在 可 靠 的 传输 协议 
《如 TCP) 之 上 ， 为 高 层 协议 提供 数据 封装 、 压 缩 、 加 窗 等 基 
本 功能 的 支持 。SSL 握 手 协议 (SSL Handshake Protocol) ， 它 
建立 在 SSL 记 录 协 议 之 上 ， 用 于 在 实际 数据 传输 开始 前 ， 通 信 
双方 进行 喘 份 认证 、 协 商 加 密 算 法 、 交 换 加 和 密 密 钥 等 。 


而 在 基于 B/S 的 Web 应 用 中 ， 是 通过 HTTPS 来 实现 SSL 的 。 
HTTPS 是 以 安全 为 目标 的 HITP 通 道 ， 简 单 讲 是 HTTP 的 安全 

















版 ， 即 在 HITP 下 加 入 SSL 层 ，HTTPS 的 安全 基础 是 SSL。 


因为 Spring Boot 用 的 是 内 花 的 Tomcat， 因 而 我 们 做 SSL 配 
置 的 时 候 需 要 做 如 下 的 操作 。 
LEUE 


使 用 SSL 首 先 需 要 一 个 证 书 ， 这 个 证 书 既 可 以 是 目 签 名 
的 ， 也 可 以 是 从 SSL 证 书 授 权 中 心 获得 的 。 本 例 为 了 演示 方 
便 ， 演 示 目 授权 证 书 的 生成 。 


每 一 个 JDK 或 者 JRE 里 都 有 一 个 工具 叫 keytool， 它 是 一 个 
证 书 管理 工具 ， 可 以 用 来 生成 自 签名 的 证 书 ， 如 图 7-11 所 示 。 




















> bin 


名 称 
^| kems.dll 


4^| jvisualvm.exe 


m] keytool.exe | [m] keytool.exe 


(a=) kinit.exe [17] kinit.exe 





























图 7-11 keytool 


在 配置 了 JAVA_HOME， 并 将 JAVA_HOME 的 bin 目 录 加 入 
到 Path 后 ， 即 可 在 控制 台 调 用 该 命令 ， 如 图 7-12 所 示 。 





























编辑 季 统 变量 x 
变量 名 (N): JAVA HOME 
ZEV: C:\Program Files\Java\jdk1.8.0 
| R= 取消 
W 
编辑 系统 变量 x 
变量 名 (N): Path 
变量 值 (V): |2-0,5.0-win64\bin;C:\Program Files\nodejs\;D:\spring-1.3.0.M1\bir-96JAVA_HOME%\bin | 
RE 取消 








图 7-12 ”将 bin 目 录 加 入 到 Path 
在 控制 台 输 入 如 下 命令 ， 然 后 按照 提示 操作 ， 如 图 7-13 上 所 


ZW o 


keytool -genkey -alias tomcat 


-genkey -alias tomcat 


RETA? 
hefe 


/自治 区 名 称 是 什么 ? 


h 区 代码 是 什么 ? 


, O=wisely, L=hefei, ST=anhui, C=86 E6 


tomcat》 的 密 钥 口令 
:和 密 钥 库 口令 相同 ， 按 回 车 ): 





图 7-13 ”按照 提示 操作 





这 时 候 我 们 在 当前 目录 下 生成 了 一 个 .keystore 文 件 ， 这 就 
是 我 们 要 用 的 证 书 文件 ， 如 图 7-14 所 示 。 


FAP > wisely 


^ gR 
certenroll.log 
npmrc 
EB ch5 2 4.zip 
EB .m2.zip 
«keystore 





图 7-14 keystore tt 
2.Spring Boot 配 置 SSL 
添加 一 个 index.html 到 src/main/resources/static 下 ， 作 为 测 
pe 


将 .keystore 文 件 复制 到 项 目的 根 目 录 ， 然 后 在 
application.properties 中 做 如 下 SSL 的 配置 : 





server.port = 8443 
server.ssl.key-store = .keystore 


server.ssl.key-store-password- 111111 
server.ssl.keyStoreType= JKS 
server.ssl.keyAlias: tomcat 


此 时 启动 Spring Boot， 控 制 台 输出 效果 如 图 7-15 所 示 。 


Tomcat started on port(s): 8443 (https) 


Started Ch74Application in 2.659 seconds (JVM running for 2.957) 














图 7-15 ”控制 台 输 出 效果 
此 时 访问 https://localhost: 8443， 效 果 如 图 7-16 所 示 。 


> f& > W ES R bhitps://localhost 


图 7-16 ”访问 localhost: 8443 
3.http#% [a] https 


很 多 时 候 我 们 在 地 址 栏 输入 的 是 http， 但 是 会 目 动 转 回 到 
https， 例 如 我 们 访问 百度 的 时 候 ， 如 图 7-17 所 示 。 





index page 














打开 新 的 标签 页 X 


X |!http://www.baidu.com 


as = 应 用 点 击 这 里 导入 书签 。 iia 








百度 一 下 ， 你 就 知道 x 





€ CQ 8 https://www.baidu.com 





17-17 ”http 自 动 转向 https 


要 实现 这 个 功能 ， 我 们 需 配 置 
TomcatEmbeddedServletContainerFactory， 并 且 添 加 Tomcat 的 
connector 来 实现 。 


这 时 我 们 需要 在 配置 文件 里 增加 如 下 配置 : 





import org.apache.catalina.Context; 

import org.apache.catalina.connector.Connector; 

import org.apache.tomcat.util.descriptor.web.SecurityCollecti 
import org.apache.tomcat.util.descriptor.web.SecurityConstrai 
import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootAppli 
import org.springframework.boot.context.embedded.EmbeddedServ 
import org.springframework.boot.context.embedded.tomcat.Tomca 
import org.springframework.context.annotation.Bean; 


QSpringBootApplication 
public class Ch74Application { 


public static void main(String[] args) { 
SpringApplication.run(Ch74Application.class, args); 


QBean 
public EmbeddedServletContainerFactory servletContainer() 
TomcatEmbeddedServletContainerFactory tomcat - new Tomc 
QOverride 


protected void postProcessContext(Context context) 
SecurityConstraint securityConstraint = new Secur 
securityConstraint.setUserConstraint ("CONFIDENTIA 
SecurityCollection collection = new SecurityColle 
collection.addPattern("/*"); 
securityConstraint.addCollection(collection); 
context.addConstraint(securityConstraint); 

} 

}; 


tomcat .addAdditionalTomcatConnectors(httpConnector()); 
return tomcat; 

J 

QBean 

public Connector httpConnector() ( 
Connector connector - new Connector("org.apache.coyote. 
connector.setScheme("http"); 
connector.setPort(8080); 
connector.setSecure(false); 
connector.setRedirectPort(8443); 
return connector; 


此 时 启动 Spring Boot， 控 制 台 输出 效果 如 图 7-18 所 示 。 


Tomcat started on port(s):[8443 (https) 8080 (http) 
Started Ch74Application in 2.464 seconds (JVM running for 2.786) 




















图 7-18 ”启动 Spring Boot 


此 时 我 们 访问 :http:Wlocalhost: 8080， 会 自动 转 到 
https://localhost: 8443， 如 图 7-19 所 示 。 


Insert title here 


US$ (x bitp'S.//localhost.2445/ 





图 7-19 ”自动 转 到 https://localhost: 8443 


7.5 Faviconfic & 


7.5.1 默认 的 Favicon 


Spring Boot 提 供 了 一 个 默认 的 Favicon， 每 次 访问 应 用 的 时 
候 都 能 看 到 ， 如 图 7-20 所 示 。 


7.5.2 ”关闭 Favicon 


我 们 可 以 在 application.properties 中 设置 关闭 Favicon， 默 认 
为 开启 ， 如 图 7-21 所 示 。 


spring.mvc.favicon.enabled=false 


| @ Insert title here x 


€ C& | D localhost:8888 


index page 





7-20 ”默认 的 Favicon 


|) 无 法 访问 http://localhos x 


C | D localhost:8888 





图 7-21 关闭 Favicon 


7.5.3 ”设置 目 己 的 Favicon 





若 需 要 设置 自己 的 Favicon， 则 只 需 将 自己 的 
favicon.ico 〈 文 件 名 不 能 变动 ) 文件 放置 在 类 路 径 根 目录 、 类 
路 径 META-INEF/resources/ 下 、 类 路 径 resources/ 下 、 类 路 径 
static/ 下 或 类 路 径 public/ 下 。 这 里 将 favicon.ico 放 置 在 
src/main/resources/static 下， 运行 效果 如 图 7-22 所 示 。 


3 Insert title here x 


œ | D localhost:8888 


index page 





7.6 WebSocket 


7.6.1 什么 是 WebSocket 





WebSocket 为 浏览 占 和 服务 端 提供 了 双 工 异步 通信 的 功 
fe, BU eae a WARS SYM Ass ARS tH HJ. EA, F8] 0] OAS 
发 送 消息 。WebSocket 需 浏览 器 的 文 持 ， 如 了 正 10+. Chrome 
13+, Firefox 6+， 这 对 我 们 现在 的 浏览 器 来 说 都 不 是 问题 。 


WebSocket 是 通过 一 个 socket 来 实现 双 工 异步 通信 和 能力 的 。 
但 是 直接 使 用 WebSocket (或 者 SockJS: WebSocket 协 议 的 模 
拟 ， 增 加 了 当 浏 览 器 不 支持 WebSocket 的 时 候 的 兼容 支持 ) 协 
议 开 发 程序 显得 特别 烦琐 ， 我 们 会 使 用 它 的 子 协 议 STOMP， 

它 是 一 个 更 高 级 别 的 协议 ，STOMP 协 议 使 用 一 个 基于 帧 
(frame) 的 格式 来 定义 消息 ， 与 HITP 的 request 和 response 类 
似 (具有 类 似 于 @RequestMapping 的 @MessageMapping) ， 我 

们 会 在 后 面 实战 内 容 中 观察 STOMP 的 帧 。 





























7.6.2 Spring Boot 提 供 的 目 动 配置 


Spring Boot 对 内 家 的 Tomcat (7 或 者 8) 、Jetty9 和 Undertow 
使 用 WebSocket 提 供 了 文 持 。 配 置 源码 存 于 
org.Springframework.boot.autoconfigure.websocket 下 ， 如 图 7-23 
所 示 。 


H3 websocket 
fn) JettyWebSocketContainerCustomizer.class 
TomcatWebSocketContainerCustomizer.class 


fn) UndertowWebSocketContainerCustomizer.class 
his WebSocketAutoConfiguration.class 


$i» WebSocketContainerCustomizer.class 


图 7-23 ”源码 存放 位 置 





Spring ”Boot 为 WebSocket 提 供 的 stater pom 是 spring-boot- 
starter-websocket. 


7.6.3 ”实战 
1. 准 备 


新 建 Spring Boot 项目， 选择 Thymeleaf 和 Websocket 依 赖 ， 
如 图 7-24 所 示 。 


New Spring Starter Project 


Name 


Type: 


Java Version: 


ch7_6 


Maven Project v Packaging: Jar 


Language: 


Boot Version: 1.3. 


Group 
Artifact 
Version 
Description 


Package 


Dependencies 
AMQP 





] Batch 


Gemfire 
HSQLDB 
JDBC 
LinkedIn 
Mustache 
[ ]Redis 
Security 





























WS 





AWS Messagin 


Turbine AMQP 


com.wisely 

ch7_6 

0.0.1-SNAPSHOT 

Demo project for Spring Boot 


com.wisely.ch7 6 


AOP 

Actuator 

Bitronix UTA) 
Cloud Connectors 


AWS 





| ]Apache Derby 
| |Cache 
Cloud Security 


g 














- ]DevTools 








| ]Elasticsearch 


[_] Facebook 








[|] Groovy Templates 








ystrix Dashboard 
JPA 
Mobile 
OAuth2 




















Remote Shell Rest Repositories 


v] Thymeleaf 


[C] Vaadin 











Solr 





Twitter 
Web 














BREE aE 


Java 


wv 


wv 


AWS JDBC 














Atomikos (JTA) 


[ ]Freemarker 








HATEOAS 





[Integration 





B rius (JAX-RS) 











Turbine 








[C] Velocity 
Zuul 








图 7-24 选择 Thymeleaf 和 Websocket 


2. 广 播 式 


三 i ， 会 将 消息 发 送 给 所 有 连接 了 当 


WA 


前 endpoint 的 浏览 


(1) 配置 WebSocket， 需 要 在 配置 类 上 使 用 
@EnableWebSocketMessageBroker 开 启 WebSocket 支 ff ， 并 通 
过 继承 AbstractWebSocketMessageBrokerConfigurer 类 ， 重 写 其 
方法 来 配置 WebSocket。 


代码 如 下 : 





package com.wisely.ch7_6; 


import 
import 
import 
import 
import 


org. 
org. 
org. 
org. 
org. 


springframework. 
springframework. 
springframework. 
springframework. 
springframework. 


@Configuration 
QEnablewebSocketMessageBroker//1 
public class WebSocketConfig extends AbstractWebSocketMessage 


QOverride 
public void registerStompEndpoints(StompEndpointRegistry 
registry.addEndpoint("/endpointWisely").withSockJS(); 


j 


QOverride 
public void configureMessageBroker(MessageBrokerRegistry 
registry.enableSimpleBroker("/topic"); //5 


j 


代码 解释 


人 通过 @EnableWebSocketMessageBroker 注 解 开启 使 用 
STOMP 协 议 来 传输 基于 代理 (message broker) 的 消息 ， 这 时 








context.annotation.Configuration; 

messaging.simp.config.MessageBroke 
web.socket.config.annotation.Abstr 
web.socket.config.annotation.Enabl 
web.socket.config.annotation.Stomp 


控制 器 支持 使 用 @MessageMapping， 就 像 使 用 
@RequestMapping 一 样 。 


@) 注 册 STOMP 协 议 的 节点 Cendpoint) ， 并 映射 的 指定 的 


URL. 


@) 注 册 一 个 STOMP 的 endpoint， 并 指定 使 用 SockJS 协 议 。 
OM AWM EARE (Message Broker) 。 
广播 式 应 配置 一 个 /topic 消 乱 代理 。 


(2) Pl ba [1 AR SS 3 ACIS 1] 13 A ECTS BESE : 





package com.wisely.ch7 6.domain; 


public class WiselyMessage ( 
private String name; 


public String getName(){ 
return name; 
j 


(3) HRS din FID V i ACIS UES EET ES Ae 


package com.wisely.ch7 6.domain; 
public class WiselyResponse { 
private String responseMessage; 
public WiselyResponse(String responseMessage) { 
this.responseMessage - responseMessage; 


public String getResponseMessage(){ 
return responseMessage; 
} 


(4) 演示 控制 各 ， 代 人 码 如 下 : 


package com.wisely.ch7_6.web; 

import org.springframework.messaging.handler.annotation.Messa 
import org.springframework.messaging.handler.annotation.SendT 
import org.springframework.stereotype.Controller; 


import com.wisely.ch7_6.domain.WiselyMessage; 
import com.wisely.ch7_6.domain.WiselyResponse; 


@Controller 


public class WsController { 
@MessageMapping("/welcome") //1 
QSendTo("/topic/getResponse") //2 
public WiselyResponse say(WiselyMessage message) throws E 
Thread.sleep(3000); 
return new WiselyResponse("Welcome, " + message.g 


代码 解释 


QD 当 浏 览 器 回 服务 端 发 送 请 求 时 ， 通 过 @MessageMapping 
映射 /welcome 这 个 地 址 ， 类 似 于 @RequestMapping。 


忆 当 服务 端 有 消 晨 时 ， 会 对 订阅 了 @SendTo 中 的 路 人 径 的 浏 
V di ACIS TE o 


(5) 添加 脚本 。 将 stomp.min.js (“STOMP 协议 的 客户 端 肢 
AS) 、sockjs.min.js (SockJS 的 客户 端 脚本 〉 以 及 jQuery 放置 在 
src/main/resources/static 下。 读者 可 在 这 一 章 的 源码 里 找到 这 几 
个 脚本 ， 或 者 自行 下 载 。 


(6) 演示 页 面 。 在 src/main/resources/templates 下 新 建 
ws.html， 代 人 码 如 下 : 








<!DOCTYPE html> 
<html xmlns:th="http://www.thymeleaf.org"> 
<head> 

<meta charset="UTF-8" /> 

<title>Spring Boot+WebSocket+ 广 播 式 </title> 





</head> 
<body onload="disconnect()"> 
<noscript><h2 style="color: #ff09690"> 貌 似 你 的 浏览 器 不 文 持 
websocket</h2></noscript> 
<div> 
<div> 





«button id="connect" onclick="connect();"> 连 接 


</button> 
<button id="disconnect" disabled="disabled" onclick=" 
断 开 连接 </button> 
</div> 
<div id="conversationDiv"> 





<label> 输 入 你 的 名 字 </label> 
<input type="text" id="name" /> 
«button id="sendName" onclick-"sendName();"»/Ex* 
«/button» 
«p id="response"></p> 
«/div» 
</div> 
<script th:src="@{sockjs.min.js}"></script> 
<script th:src="@{stomp.min.js}"></script> 
<script th:src="@{jquery.js}"></script> 
<script type="text/javascript"> 
var stompClient = null; 


function setConnected(connected) { 
document .getElementById('connect').disabled = connect 
document .getElementById('disconnect').disabled = !con 
document .getElementById('conversationDiv').style.visi 
$('#response').html(); 


j 


function connect() { 
var socket = new SockJS('/endpointWisely'); //1 
stompClient - Stomp.over(socket); //2 
stompClient.connect({}, function(frame) ( //3 
setConnected(true); 
console.log('Connected: ' + frame); 
stompClient.subscribe('/topic/getResponse', funct 
{ //4 
showResponse( JSON.parse(respnose.body).respon 
3); 
3): 


function disconnect() { 
if (stompClient !- null) ( 
stompClient.disconnect(); 


setConnected(false); 
console.log("Disconnected"); 


j 


function sendName() { 
var name = $('#name').val(); 
//5 


stompClient.send("/welcome", {}, JSON.stringify({ 'na 
} 


function showResponse(message) { 
var response = $("#response"); 
response.html(message); 


«/script» 
«/body» 
</html> 


代码 解释 

(DD 连接 SockJS 的 endpoint 名 称 为 “/endpointWisely”。 
地 使 用 STOMP 子 协议 的 WebSocket 客 户 端 。 

@@ 连 接 WebSocket 服 务 端 。 


出 通过 stompClient.subscribe 订 阅 /topic/getResponse 目 标 
(destination) 发 送 的 消息 ， 这 个 是 在 控制 器 的 @SendTo 中 定 
X 的 o 


(558 i stompClient.send[5]/welcome H £s (destination) 发 送 
id. WKS ee EE Till moMessageMapping'P E LH. 


(7) 配置 viewController， 为 ws.html 提 供 便捷 的 路 径 映 








f. 


QConfiguration 
public class WebMvcConfig extends WebMvcConfigurerAdapter { 


QOverride 
public void addViewControllers(ViewControllerRegistry 
registry.addViewController("/ws").setViewName("/ws 
} 


(8) 运行 。 我 们 预 o 当 一 个 浏览 
TAS BY AR Y ET 其 他 浏览 VES 


个 消息 4D o 


开启 三 个 浏览 器 窗口 ， 并 访问 http: Caha 8080/ws, 4] 
AE BER A 4s. AEAN Vcn PAIK RIB, DATA Vd 
器 接收 消息 。 





发 送 一 个 
能 接收 到 从 服务 端 发 送 来 的 这 








连接 服务 端 ， 如 图 7-25 所 示 。 


























- 0 x = BH x - BH x 
ai Spri x T /aispri x ei Sprit x 
C | D localhost:8( | = Pr € œŒ D localhost:8í = | e C |D localhost8Cv»| = 
t ， | 断 开 连 接 连接 | 断 开 连 接 ii | | 断 开 连接 
输入 你 的 名 字 输入 你 的 名 字 输入 你 的 名 字 
发 送 发 送 
> y HET 
图 7-25 ”连接 服务 器 
一 个 浏览 器 发 送 消息 ， 如 图 7-26 所 示 
y 4? H 7-26 ZJN o 
= HU X = 0 X = BH x 
ei Spri: x gf Spri: x ei Spri x 
C | D localhost:8( vx = f| € C D localhost: ze C | D localhost:8( t7 = 
Ec EIE Es] gis 
输入 你 的 名 宁 输入 你 的 名 字 输入 你 的 名 字 
[wf o ë] 发 送 








图 7-26 RAYA 
所 有 浏览 堪 接 收服 务 端 发 送 的 消息 ， 如 图 7-27 所 示 。 





— —H x = X = Ug x 
g Spri: x ei Spri x ei Spri: x 
c localhost8( 交 = f| € C | [5localhost8( vv) = || € G localhost:8( = 
连接 | 断 开 连 接 连接 | | 断 开 连接 = | | HAR 
ATE - 输入 你 的 名 字 | ARE 
Welcome, wyf! Welcome, wyf! Welcome, wyf! 








图 7-27 所 有 浏览 器 接收 信息 
我 们 在 Chrome 浏 览 器 (在 Chrome 下 按 F12 调 出 ) 下 观察 一 


下 STOMP 的 帧 ， 如 图 7-28 所 示 。 





图 7-28 ”观察 STOMP 的 帧 
从 上 述 截图 可 以 观察 得 出 ， 连 接 服务 端的 格式 为 : 





CONNECT 
accept-version:1.1,1.0 
heart -beat :10000, 10000 


连接 成 功 的 返回 为 : 


CONNECTED 
version:1.1 
heart-beat:0,0 


Wk) HER (destination) /topic/getResponse: 


SUBSCRIBE 
id:sub-0 
destination: /topic/getResponse 


[=] H# (destination) /welcome 发 送 消息 的 格式 为 : 


SEND 

destination: /welcome 
content-length:14 
{\"name\":\"wyf\"} 


MAHER (destination) /topic/getResponse 接 收 的 格式 为 : 


MESSAGE 

destination: /topic/getResponse 

content -type:application/json;charset=UTF-8 
subscription: sub-0 

message-id: zxj4wyau-0 

content-length:35 
{\"responseMessage\":\"Welcome, wyf!\"} 


ON SPOT 


广播 式 有 自己 的 应 用 场景 ， 但 是 广播 式 不 能 解决 我 们 一 个 
常见 的 场景 ， 即 消 恩 由 谁 发 送 、 由 谁 接收 的 问题 。 


本 例 中 演示 了 一 个 简单 的 聊天 室 程序 。 例 子 中 只 有 两 个 用 
户 ， 互 相 发 送 消 居 给 彼此 ， 因 需要 用 户 相 关 的 内 容 ， 所 以 先 在 
这 里 引入 最 简单 的 Spring Security 相 关内 容 。 








(1) 添加 Spring Security 的 starter pom: 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
security</artifactId> 
</dependency> 


(2) Spring Security 的 简单 配置 。 这 里 不 对 Spring Security 
做 过 多 解释 ， 只 解释 对 本 项 目 有 帮助 的 部 分 : 





@Configuration 

QEnablewebSecurity 

public class WebSecurityConfig extends WebSecurityConfigurerA 
QOverride 


protected void configure(HttpSecurity http) throws Except 


http 

.authorizeRequests() 
.antMatchers("/","/1ogin").permitAll()//1i 
.anyRequest().authenticated() 
.and() 
.formLogin() 
.loginPage("/login") //2 
.defaultSuccessUrl("/chat") //3 
.permitAll() 
.and() 
.logout() 
.permitAll(); 

} 

//4 

QOverride 

protected void configure(AuthenticationManagerBuilder aut 

auth 

.inMemoryAuthentication() 
.WithUser("wyf").password("wyf").roles("USER" 
.and() 
.WithUser("wisely").password("wisely").roles( 

} 

//5 

@Override 


public void configure(WebSecurity web) throws Exception { 
web.ignoring().antMatchers("/resources/static/**"); 


代码 解释 

(D Spring Security 对 /和 /“login” 路 径 不 拦截 。 
Dix E Spring Security 的 登录 页 面 访问 的 路 径 为 /login。 
人) 登录 成 功 后 转 癌 /chat 路 径 。 


在 内 存 中 分 别 配 置 两 个 用 户 wyf 和 wisely， 密 码 和 用 户 名 
一 致 ， 角 色 是 USER。 





截 。 


(Bresources/static/ 目 录 下 的 静态 资源 ，Spring Security 不 拦 


(3) 配置 WebSocket: 


@Configuration 
QEnablewebSocketMessageBroker 
public class WebSocketConfig extends AbstractWebSocketMessage 


QOverride 

public void registerStompEndpoints(StompEndpointRegistry 
registry.addEndpoint("/endpointWisely").withSockJS(); 
registry.addEndpoint("/endpointChat").withSockJS();// 


QOverride 

public void configureMessageBroker(MessageBrokerRegistry 
registry.enableSimpleBroker("/queue","/topic"); //2 

J 


代码 解释 
QD 注册 一 个 名 为 /endpointChat 的 endpoint。 
句点 对 点 式 应 增加 一 个 /queue 消 轧 代 理 。 
(4) 控制 器 。 在 WsController 内 添加 如 下 代码 : 


@Autowired 
private SimpMessagingTemplate messagingTemplate;//1 


QMessageMapping("/chat") 
public void handleChat(Principal principal, String msg) { 
if (principal.getName().equals("wyf")) (//3 
messagingTemplate.convertAndSendToUser("wisely", 
"/queue/notifications", principal.getName 


send:" 


+ msg); //4 
) else ( 


messagingTemplate.convertAndSendTouser ("wyf", 
"/queue/notifications", principal.getName 


+ msg); 


代码 解释 
(通过 SimpMessagingTemplate 回 浏览 器 发 送 消息 。 


@ 在 Spring MVC 中 ， 可 以 直接 在 参数 中 获得 principal， 
pinciple 中 包含 当前 用 户 的 信息 。 


(3 这 里 是 一 段 硬 编码 ， 如 果 发 送 人 是 wyf， 则 发 送 给 
wisely; 如 果 发 送 人 是 wisely， 则 发 送 给 wyf， 读 者 可 以 根据 项 
目 实 际 需 要 改写 此 处 代码 。 








通过 messagingTemplate.convertAndSendToUser 向 用 户 发 
送 消 息 ， 第 一 个 参数 是 接收 消 晨 的 用 户 ， 第 二 个 是 浏览 器 订阅 
的 地 址 ， 第 三 个 是 消息 本 身 。 














(5) 登录 页 面 。 在 src/main/resources/templates 下 新 建 
login.html， 代 码 如 下 : 


<!DOCTYPE html> 
<html xmins="http://www.w3.org/1999/xhtml" xmlns:th="http://w 
xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras- 
springsecurity3"> 
<meta charset="UTF-8" /> 
<head> 
<title> 登 录 页 面 </title> 
</head> 
<body> 


<div th:if="${param.error}"> 


无 效 的 账号 和 密码 
</div> 
«div th:if="${param.logout}"> 
你 已 注销 
</div> 
«form th:action="@{/login}" method="post"> 
<div><label> WK 
写 : <input type="text" name="username"/> </label></div> 
<div><label> 密 


fU: <input type="password" name="password"/> </label></div> 
<div><input type="submit" value=" 登 陆 "/></div> 

</form> 

</body> 

</html> 


(6) HA Ui. fEsrc/main/resources/templates F it 
chat.html， 代 码 如 下 : 


<!DOCTYPE html» 


<html xmins:th="http://www.thymeleaf.org"> 
<meta charset="UTF-8" /> 
<head> 
<title>Home</title> 
<script th:src="@{sockjs.min.js}"></script> 
<script th:src="@{stomp.min.js}"></script> 
<script th:src="@{jquery.js}"></script> 
</head> 
<body> 


<p> 
MRE 
</p> 


<form id="wiselyForm"> 
«textarea rows="4" cols="60" name="text"></textarea> 
<input type="submit"/> 

</form> 


<script th:inline="javascript"> 
$('ZwiselyForm').submit(function(e)( 
e.preventDefault(); 
var text = $('ZwiselyForm').find('textarea[name-z"text 


sendSpittle(text); 
3); 


var sock - new SockJS("/endpointChat"); //1 

var stomp - Stomp.over(sock); 

stomp.connect('guest', 'guest', function(frame) ( 
stomp.subscribe("/user/queue/notifications", handleNo 

3); 


function handleNotification(message) { 
$('#output').append(" 
<b>Received: " + message.body + "</b><br/>") 


j 


function sendSpittle(text) { 
stomp.send("/chat", {}, text);//3 


} 
$('#stop').click(function() {sock.close()}); 
</script> 


<div id="output"></div> 


</body> 
</html> 


代码 解释 
连接 endpoint 名 称 为 “endpointChat” 的 endpoint。 


@ 订 阅 /usevqueue/notifications 发 送 的 消息 ， 这 里 与 在 控制 
器 的 messagingTemplate.convertAndSendToUser 中 定义 的 订阅 地 
址 保持 一 致 。 这 里 多 了 一 个 maser， 并 且 这 个 /user 是 必须 的 ， 使 
用 了 mser 才 会 用 送 消息 到 指定 的 用 户 。 


(7) 增加 页 面 的 viewController: 











@Configuration 
publicclass WebMvcConfig extends WebMvcConfigurerAdapter { 


@Override 


publicvoid addViewControllers(ViewControllerRegistry regi 
registry.addViewController("/ws").setViewName("/ws"); 

registry.addViewController("/login").setViewName("/login" 
registry.addViewController("/chat").setViewName("/chat"); 


(8) 运行 。 我 们 预期 的 效果 是 : 两 个 用 户 登 录 系 统 ， 可 
Da RIS. 但 是 个 浏览 器 的 用 户 会 话 session 是 共享 的 ， 我 
们 可 以 在 谷歌 浏览 器 设置 两 个 独立 的 用 户 ， 从 而 实现 用 户 会 话 
session 隔 房 ， 如 图 7-29 所 示 。 


现在 分 别 在 两 个 用 户 下 的 浏览 器 访问 : http://localhost: 
8080/login， 并 登录 ， 如 网 7-30 所 示 。 


wyf 用 户 癌 wisely 用 户 发 送 消息 ， 如 图 7-31 所 示 。 
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图 7-29 ”两 个 独立 的 用 户 









































wt 一 口 x 
i—, 
€ > Q [D localhost:8080/login THE 
me 
图 7-30 “分别 登录 
=a a x 
- gj Home x \ P, gj Home x _ 
口 localhost:8080/chat € > C D localhost:8080/chat x 三 
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提交 




























S /四 Home x y i Fw E Home x \ 
> QC |D localhost:8080/chat € > QC [localhost:8080/chat 














聊天 室 





hello there! 


Received: wyf-send:hello 





Received: wisely-send:hello there! 














图 7-32 ”wisely 用 户 向 wyf 用 户 发 送 消息 


7.7 3+ Bootstrap fll AngularJS Hy Hif Web 
应 用 


现代 的 B/S 系 统 软件 有 下 面 几 个 特色 。 
1. 单 页 面 应 用 


单 页 面 应 用 〈single-page application， 简 称 SPA) 指 的 是 一 
种 类 似 于 原生 客户 端 软件 的 更 流畅 的 用 户 体 验 的 页 面 。 在 单 页 
面 应 用 中 ， 所 有 的 资源 (HTML, JavaScript, CSS) 都 是 按 需 
动态 加 载 到 页 面 上 的 ， 且 不 需要 服务 端 控制 页 面 的 转 同 。 


2. 啊 应 式 设计 


响应 式 设计 (Responsive web design， 简 称 RWD) 指 的 是 
不 同 的 设备 《电脑 、 平 板 、 手 机 ) 访问 相同 的 页 面 的 时 候 ， 得 
到 不 同 的 页 面 视 图 ， 而 得 到 的 视图 是 适应 当前 屏 大 的。 当然 就 
算 在 电脑 上 ， 我 们 通过 拖 动 浏览 器 窗口 的 大 小 ， 也 能 得 到 合适 
的 视图 。 

3. 数 据 叶 问 

数据 导 回 是 对 于 页 面 导 同 而 言 的 ， 页 面 上 的 数据 获得 是 通 
过 消费 后 台 的 REST 服 务 来 实现 的 ， 而 不 是 通过 服务 器 泻 染 的 
动态 页 面 〈 如 JSP) 来 实现 的 ， 一 般 数 据 交 换 使 用 的 格式 是 
JSON. 


本 节 将 针对 Bootstrap 和 AngularJS 进 行 快 速 入 门 式 的 引导 ， 
如 需 深 入 学 习 ， 请 参考 官网 或 相关 专题 书籍 。 
































7.7.1 Bootstrap 


1.1 A Bootstrap 


Bootstrap 7j XE X: Bootstrap 是 开发 啊 应 式 和 移动 优先 的 
Web 应 用 的 最 流行 的 HTML、CSS、JavaScript 框 架 。 


Boostrap 实 现 了 只 使 用 一 套 代码 就 可 以 在 不 同 的 设备 显示 
你 想 要 的 视图 的 功能 。Bootstrap 还 为 我 们 提供 了 大 量 美观 的 
HTML 元 素 前 端 组 件 和 jQuery 插件 。 


2. 下 载 并 引入 Bootstrap 


下 载 地 址 :http://getbootstrap.com/getting-started/， 如 图 7- 
33 ATA o 











Bootstrap 


Compiled and minified CSS, JavaScript 
and fonts. No docs or original source files 


are included 


Download Bootstrap 


图 7-33 ”下 载 页 面 
下 载 的 压缩 包 的 目录 结构 如 图 7-34 所 示 。 














全 = Ba bootstrap-3.3.5-dist.zip\bootstrap-3. 3.5-dist - 解 包 大 小 为 1.0 MB 


名 称 压缩 前 es 。 关 型 














1 (上 级 目录 ) SUSE 

| | fonts 文件 去 

His 文件 去 
图 7-34 ”目录 结构 


最 简单 的 Bootstrap 页 面 模板 如 下 : 


<!DOCTYPE html» 
<html lang="zh-cn"> 
<head> 
<meta charset="utf-8"> 
<meta http-equiv="X-UA-Compatible" content="IE=edge"> 
<meta name="viewport" content="width=device- 

width, initial-scale=1"> 

<!-- 上 面 3 个 meta 标 签 必须 是 head 的 头 三 个 标签 ， 其 余 的 head 内 标签 在 此 
3 个 之 后 
The above 3 meta tags *must* come first in the head; any othe 
-> 

<title>Bootstrap 基 本 模板 </title> 


<!-- Bootstrap 的 CSS --> 
<link href="bootstrap/css/bootstrap.min.css" rel="stylesh 


<!-- HTML5 shim 


and Respond .js 用 来 让 IE 8 支持 HTML 5 元 素 和 媒体 查询 --» 


<!--[if lt IE 9]> 
<script src 


-"js 


/html5shiv.min.js"></script> 
<script src 


-"js 


/respond.min.js"></script> 
<! [endif 


]--> 
</head> 
<body> 
<h1> 你 好 ，Bootstrap!</hi1> 





«1-- jQuery 是 Bootstrap 脚 本 插件 必需 的 - -> 
<script src="js/jquery.min.js"></script> 
«1-- 包含 所 有 编译 的 插件 --> 
<script src="bootstrap/js/bootstrap.min.js"></script> 
</body> 
</html> 








3.CSS x: H 


Bootstrap 的 CSS 样 式 为 基础 的 HTML 元 素 提 供 了 美观 的 样 
式 ， 此 外 还 提供 了 一 个 高 级 的 网 格 系统 用 来 做 页 面 布局 。 


(1) 布局 网 格 





在 Bootstrap 里 ， 行 使 用 的 样式 为 rrw， 列 使 用 col-md- 数 
字 ， 此 数字 范围 为 1 一 12， 上 所 有 列 加 起 来 的 和 也 是 12， 代 码 如 
下 : 


<div class="row"> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
<div class="col-md-1">.col-md-1</div> 
</div> 
<div class="row"> 
<div class="col-md-8">.col-md-8</div> 
«div class="col-md-4">.col-md-4</div> 
</div> 
<div class="row"> 
<div class="col-md-4">.col-md-4</div> 
«div class="col-md-4">.col-md-4</div> 
<div class="col-md-4">.col-md-4</div> 
</div> 
<div class="row"> 
<div class="col-md-6">.col-md-6</div> 
<div class="col-md-6">.col-md-6</div> 
</div> 


布局 效果 如 图 7-35 所 示 。 


col- col- col- col- col- col- col- col- col- col- col- col- 
md-1 md-1 md-1 md-1 md-1 md-1 md-1 md-1 md-1 md-1 md-1 md-1 


col-md-8 col-md-4 
col-md-4 col-md-4 col-md-4 


col-md-6 col-md-6 


图 7-35 布局 效果 
(2) html 元 素 


Bootstrap 为 html 元 素 提 供 了 大 量 的 样式 ， 如 表单 元 素 、 按 
钮 、 图 标 等 。 更 多 内 容 请 查看 : http://getbootstrap.com/css/。 


4. 页 面 组 件 支持 


Bootstrap 为 我 们 提供 了 大 量 的 页 面 组 件 ， 包 括 字 体 图 标 、 
PRE. SISK. BEER, FRIAS, uS YS 
http://getbootstrap.com/components/. 

















5. Javascript 32 4f 


Bootstrap 为 我 们 提供 了 大 量 的 JavaScript 插 件 ， 包 含 模式 对 
话 框 、 标 签 页 、 提 示 、 和 警告 等 ， 更 多 内 容 请 查看 
http://getbootstrap.com/javascript/. 











7.7.2 AngularJS 


1. 什 么 是 AngularJS 


AngularJS 官 方 定义 : AngularJS 是 HTML 开 发 本 应 该 的 样 
子 ， 它 是 用 来 设计 开发 Web 应 用 的 。 


AngularJS 使 用 声名 式 模板 + 数据 绑 定 《类 似 于 JSP、 
Thymeleaf) ~ MVW (Model-View-Whatever) 、 
MVVM (Model-View-ViewModel) 、MVC (Model-View- 
Controller) 、 依 赖 注入 和 测试 ， 但 是 这 一 切 的 实现 却 只 借助 纯 
客户 端的 JavaScript。 


HTML 一 般 是 用 来 声明 静态 页 面 的 ， 但 是 通常 情况 下 我 们 








45 2B Va [i ee 45 T ASEM, CH ESAME S ARS Yu x 
引擎 出 现 的 原因 ; 而 AngularJS 可 以 只 通过 前 端 技术 就 实现 动 
态 的 页 面 。 

2. 下 载 并 引入 AngularJS 


AngularJS 下 载 地 址 : https:/angularjs.org/， 如 图 7-36 所 示 。 








Download AngularJS 


Branch | 1.4.x (stable) | 1.2.x (legacy) e 
Build | Minified | Uncompressed Zip e 
e 


CDN  https-//ajax.googleapis.com/ajax/libs/angularjs/1.4.2/angular.min s 一 


Bower bower install angular£ 4.2 e 


npm npm install angular(1.4.2 


EXER Browse additional modules 





Previous Versions 


ih Download 

















图 7-36 ”下载 页 面 
最 简单 的 AngularJS 页 面 : 


<!doctype html» 
<html ng-app><!-- 1 --> 
<head> 
<script src="js/angular.min.js"></script><!-- 2 --> 
</head> 
<body> 
<div> 
<label>#%:</label> 
<input type="text" ng-model-"yourName" placeholder-"ü 
入 你 的 名 字 "><!1-- 3 --> 
<hr> 
<h1> 你 好 {{yourName}}!</h1><!-- 4 --> 
</div> 


</body> 
</html> 


代码 解释 


Cng-app 所 作用 的 范围 是 AngularJS 起 效 的 范围 ， 本 例 是 整 
^ VALEUR XC. 


@) 载 入 AngularJS 的 脚本 。 

G)ng-model 定 义 整个 AngularJS 的 前 端 数据 模型 ， 模 型 的 名 
称 为 yourName， 模 型 的 值 来 自 你 输入 的 值 徊 输入 的 值 改变 ， 
则 数据 模型 值 也 会 改变 。 


使 用 {{ 模 型 名 上} 来 读 取 模型 中 的 值 。 


























效果 如 图 7-37 所 示 。 
名 字 : |wisely ] 名 字 : [wyf 
你 好 wisely! 你 好 wyf! 

















图 7-37 ”运行 效果 
3. 便 块 、 控 制 硕 和 数据 绑 定 
我 们 对 MVC 的 概念 已 经 烂熟 于 心 了 ， 但 是 平时 的 MVC 都 


是 服务 端的 MVC， e € ed ml]MVC, 
即 实现 了 视图 模板 、 数 据 模 型 、 代 码 控制 的 分 


再 来 看 看 数据 绑 定 ， 数 据 绑 定 是 将 视 风 和 数据 模型 绑 定 在 


一 起 。 如 有 果 视 图 变 了 了 ， 则 模型 的 值 就 变 了 ;如 宋 模 型 值 变 了 ， 
则 视图 也 会 跟着 改变 。 

















AngularJS 为 了 分 离 代 码 达 到 复 用 的 效果 ， 提 供 了 一 个 
module〈 模 块 ) 。 定 义 一 个 模块 需 使 用 下 面 的 代码 。 


无 依赖 模块 : 








angular.module('firstModule',[]); 


有 依赖 模块 : 


angular .module('firstModule', ['moduleA', 'moduleB']); 


RIAR T VC AE ATTE VB GR. Matz dX Ang- 
model, ACHE? 我 们 可 以 通过 下 面 的 代码 来 定义 控制 器 ， 页 
面 使 用 ng-controller 来 和 其 关联 : 


angular .module('firstModule', []) 
.controller('firstController', function(){ 


H 
); 


«div ng-controller="firstController"> 


</div> 


4.Scope 和 Event 
(1) Scope 


Scope 是 AngularJS 的 内 置 对 象 ， 用 $Scope 来 获得 。 在 Scope 


中 定义 的 数据 是 数据 模型 ， 可 以 通过 {{ 模 型 名 }} 在 视图 上 获 
得 。Scope 主 要 是 在 编码 中 需要 对 数据 模型 进行 处 理 的 时 候 使 
用 ，Scope 的 作用 范围 与 在 页 面 声 明 的 范围 一 致 〈 如 在 
controller 内 使 用 ，scope 的 作用 范围 是 页 面 声明 ng-controller 标 
签 元 素 的 作用 范围 ) 。 


EX 











$scope.greeting-'Hello' 


获取 : 


{{greeting}} 


(2) Event 


因为 Scope 的 作用 范围 不 同 ， 所 以 不 同 的 Scope 之 间 行 要 区 
互 的 话 需 要 通过 事件 Event) 来 完成 。 


1) 冒 泡 事件 Emit) BWH MAT Scopen ERIZE 
件 ， 示 例如 下 。 


df Scope X: 





$scope.$emit('EVENT NAME EMIT ', 'message'); 


父 Scope 接 受 : 


$scope.$on(''EVENT_NAME_EMIT', function(event, data) { 


t) 


2) 广播 事件 (Broadcast) 。 广 播 事 件 负 责 从 父 Scope 向 下 
发 送 事件 ， 示 例如 下 。 


父 Scope 发 送 : 


$scope.$broadcast('EVENT NAME BROAD ', 'message'); 


子 scope 接 受 


$scope.$on(''EVENT_NAME_BROAD', function(event, data) { 


t) 


5. 多 视图 和 路 由 

多 视图 和 路 由 是 AngularJS 实 现 单 页 面 应 用 的 技术 关键 ， 
AngularJS 内 置 了 一 个 $routeProvider 对 象 来 负责 页 面 加 载 和 页 
面 路 由 转 问 。 


需要 注意 的 是 ，1.2.0 之 后 的 AngularJS 将 路 由 功能 移出 ， 所 
以 使 用 路 由 功能 要 另外 引入 angular-route.js 


例如 : 





angular .module('firstModule').config(function($routeProvider) 
$routeProvider .when('/view1', { //1 
controller: 'Controller1', //2 


templateUrl: 'viewi.html', //3 
}).when('/view2', { 

controller: 'Controller2', 

templateUrl: 'view2.html', 


3 
代码 解释 

中 此 处 定义 的 是 茶 个 页 面 的 路 由 名 称 。 

书 此 处 定义 的 是 当前 页 面 使 用 的 控制 器 。 

(3) 此 处 定义 的 要 加 载 的 真实 页 面 。 

在 页 面 上 可 以 用 下 面 代码 来 使 用 我 们 定义 的 路 由 : 





<ul> 
<li><a href="#/view1">view1</a></1i> 
<li><a href="#/view2">view2</a></1i> 
</ul> 
<ng-view></ng-view> «!-- 此 处 为 加 载 进来 的 页 面 显示 的 位 置 - -> 





6. 依 赖 注入 


依赖 注入 是 AngularJS 的 一 大 酶 炫 功能 。 可 以 实现 对 代码 的 
解 厢 ， 在 代码 里 可 以 注入 AngularJS 的 对 象 或 者 我 们 自 定 义 的 
对 象 。 下 面 示例 是 在 控制 器 中 注入 $scope， 注 意 使 用 依赖 注入 
的 代码 格式 。 








angular .module('firstModule' ) 
.controller("diController", ['$scope', 
function ($scope) { 


t]); 


7.Service#ll Factory 


AngularJ$ 为 我 们 内 置 了 一 些 服务 ， 如 $location、 
$timeout、$rootScope (请 读者 目 行 学 习 相 关 的 知识 ) 。 很 多 时 
候 我 们 需要 目 己 定制 一 些 服务 ，AngularJS 为 我 们 提供 了 


Service 和 Factory。 











Service 和 Factory 的 区 别 是 : 使 用 Service 的 话 ，AngularJS 会 
使 用 new 来 初始 化 对 象 ， 而 使 用 Factory 会 直接 获得 对 象 。 





(1) Service 
定义 : 


angular .module('firstModule').service('helloService', function 


this.sayHello=function(name) { 
alert('Hello '+name); 


J): 


注入 调用 : 


angular.module('firstModule') 
.controller("diController", ['$scope', 'helloService', 
function ($scope,helloService) { 
helloService.sayHello('wyf'); 
31); 


(2) Factory 
定义 : 


angular .module('firstModule').service('helloFactory', function 


t 
return{ 
sayHello: function(name) { 
alert('Hello '+name); 


3); 


注入 调用 : 


angular .module('firstModule' ) 
.controller("diController", ['$scope', 'helloFactory', 
function ($scope, helloFactory) { 
helloFactory.sayHello('wyf'); 
31); 


8.http 操 作 
AngularJS 内 置 了 $http 对 象 用 来 进行 Ajax 的 操作 : 


$http.get(url) 
$http.post(url, data) 
$http.put(url, data) 
$http.delete(url) 
$http.head(url) 


9. 目 定义 指令 

AngularJS 内 置 了 大 量 的 指令 (directive) ， 如 ng-repeat、 
ng-show、ng-model 等 。 即 使 用 一 个 简短 的 指令 可 实现 一 个 前 
3m ZH fT . 


比方 说 ， 有 一 个 日 期 的 jyjQuery 插 件 ， 使 用 AngularJS 封 装 


后 ， 在 页 面 上 调用 此 插件 可 以 通过 指令 来 实现 ， 例 如 ; 


元 素 指令 : <date-picker></date-picker> 

属性 指令 : <input type="text" date-picker/> 

样式 指令 : <input type="text" class="date-picker"/> 
注释 指令 : <!--directive:date-picker--> 





EX HT: 


angular.module('myApp', 
[]).directive('helloworld', function() { 
return ( 

restrict: 'AE',// 支 持 使 用 属性 、 元 素 

replace: true, 

template: '<h3>Hello, World!</h3>' 








WW 
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调用 指令 ， 元 素 标签 : 


<hello-world/> 


<hello:world/> 





或 者 属性 方式 : 


«div hello-world /> 


7.7.3 ”实战 


在 前 面 两 节 ， 我 们 快速 介绍 了 Bootstrap 和 AngularJS， 本 节 
我 们 将 它们 和 Spring Boot 串 起 来 做 个 例子 。 


在 例子 中 ， 我 们 使 用 Bootstrap 制 作 导 航 ， 使 用 AngularJS 实 
现 导航 切换 页 面 的 路 由 功能 ， 并 演示 AngularJS 通 过 $http 服 务 
和 Spring ”Boot 提供 的 REST 服 务 ， 最 后 演示 用 指令 封装 jQuery 
UII H BAe PER o 


1. 新 建 Spring Bootlit H 


初始 化 一 个 Spring Boot 项 目 ， 依 赖 只 需 选 择 Web (spring- 
boot-starter-web) 。 


项 目 信 息 : 








groupId: com.wisely 
arctifactId:ch7_7 
package: com.wisely.ch7_7 


准备 Bootstrap、AngularJS、jQuery、jQueryUI 相 关 的 资源 
到 src/main/resources/static 下 ， 结 构 如 图 7-38 所 示 。 


4 (® src/main/resources 
4 (& static 
4 © bootstrap 
> E» css 
> & fonts 
P & js 
4 © Jqueryui 
> B images 
jquery-ui.min.css 
jquery-ui.min.js 
4 [Js 
angular-route.min.js 
angular.min.js 
html5shiv.min.js 
jquery.min,js 
respond.min,js 





图 7-38 结构 


另外 要 说 明 的 是 ， 本 例 的 页 面 都 是 静态 页 面 ， 所 以 全 部 放 
置 在 /static 目 录 下 。 


2. fl f E S 


页 面 位 置 : src/main/resources/static/action.html : 


<!DOCTYPE html» 
<html lang="zh-cn" ng-app="actionApp"> 
<head> 


<meta charset="utf-8"> 

<meta http-equiv="X-UA-Compatible" content="IE=edge"> 

«meta name="viewport" content="width=device-width, initial- 
scale-1"» 

<title>xik</title> 


<link href="bootstrap/css/bootstrap.min.css" rel="stylesheet" 
«link href="jqueryui/jquery-ui.min.css" rel="stylesheet"> 
<style type="text/css"> 


content { 
padding: 100px 15px; 
text-align: center; 


</style> 


<!--[if 1t IE 9]> 
«script src="js/html5shiv.min.js"></script> 
<script src="js/respond.min.js"></script> 
<! [endif ]--> 
</head> 
<body> 
<l-- 1 --» 
«nav class="navbar navbar-inverse navbar-fixed-top"» 
«div class-'"container"» 


«div id="navbar" class="collapse navbar-collapse"> 
«ul class="nav navbar-nav"> 
<li><a hrefz'4/oper"»/H& X H«/a»«/li» 
<li><a href="#/directive">H i X484 «/a»«/1li» 
</ul> 
</div> 
</div> 
</nav> 





«1-- 2 --» 
«div class="content"> 
<ng-view></ng-view> 
</div> 
<l-- 3 --> 
<script src="js/jquery.min.js"></script> 
<script src="jqueryui/jquery-ui.min.js"></script> 
«script src="bootstrap/js/bootstrap.min.js"></script> 
<script src="js/angular.min.js"></script> 
<script src="js/angular-route.min.js"></script> 
«script src="js-action/app.js"></script> 
<script src="js-action/directives.js"></script> 
<script src="js-action/controllers.js"></script> 


</body> 
</html> 


代码 解释 


(使 用 Bootstrap 定 义 的 导航 ， 并 配合 AngularJ$ 的 路 由 ， 通 
过 路 由 名 称 ##oper 和 和 #/directive 切 换 视图 ; 


@) 通 过 <ng-view></ng-view> 展 示 载 入 的 页 面 。 


(3 加 载 本 例 所 需 的 脚本 ， 其 中 jquery-ui.min.js 的 脚本 是 为 我 
们 定制 指令 所 用 ; app.js 定 义 AngularJS 的 模块 和 路 由 ; 
directives.js 为 自 定 义 的 指令 ; controllers.js 是 控制 器 定义 之 处 。 


3. 模 块 和 路 由 定义 


页 面 位 置 src/main/resources/static/js-action/app.js: 


var actionApp = angular .module('actionApp', 
['ngRoute']); //1 


actionApp.config(['S$routeProvider' , function($routeProvider ) 
$routeProvider.when('/oper', ( //3 
controller: 'ViewiController', //4 
templateUrl: 'views/viewi.html', //5 
)).when('/directive', { 
controller: 'View2Controller', 
templateUrl: 'views/view2.html', 
3); 
31); 


代码 解释 
定义 模块 actionApp， 并 依赖 于 路 由 模块 ngRout。 


地 配置 路 由 ， 并 注入 $routeProvider 来 配置 。 
(3)/oper 为 路 由 名 称 。 

controller 定 义 的 是 路 由 的 控制 器 名 称 。 
(StemplateUrl 定 义 的 古 视图 的 真正 地 址 。 
4. 控 制 器 定义 


脚本 位 置 : src/main/resources/static/js-action/controllers.js: 


//1 
actionApp.controller('ViewiController', ['$rootScope', '$scop 
//2 
$scope.$on( '$viewContentLoaded', function() { 
console,1og( -页面 加 载 完成 ' )， 
3); 


//3 
$scope.search = function(){//3.1 
personName = $scope.personName; //3.2 
$http.get('search',( //3.3 
params: {personName: personName}//3.4 
}).success(function(data){ //3.5 
$scope.person=data; //3.6 


了 


ti 
31); 


actionApp.controller('View2Controller', ['$rootScope', '$scop 
$scope.$on('$viewContentLoaded', function() { 
console,1og( -页面 加 载 完成 ' )， 
3); 


31); 


代码 解释 
DE Fe Hill 48 View1Controller, FFE AS$rootScope. $scope 


和 $http 。 


@) 使 用 $scope.$on 监 听 $viewContentLoaded 事 件 ， 可 以 在 页 





面 内 容 加 载 完成 后 进行 一 些 操 作 。 


3) 这 段 代 码 是 这 个 演示 的 核心 代码 ， 请 结合 下 面 的 Viewl 


的 界面 一 起 理解 : 





年 scope 内 定义 一 个 方法 search， 在 页 面 上 通过 ng-click 调 
通过 $scope.personName 获 取 页 面 定 义 的 ng- 
model=“personName” 的 值 。 

使 用 $http.get 向 服务 端 地 址 search 发 送 get 请 求 。 

使 用 params 增 加 请 求 参 数 。 

用 success 方 法 作为 请 求 成 功 后 的 回调 。 

将 服务 端 返回 的 数据 data 通 过 $scope.person 赋 给 模型 
person， 这 样 页 面 视图 上 可 以 通过 {{person.name}}、 

{{fperson.age}}、{{person.address}} 来 调用 ， 且 模型 person 
值 改 变 后 ， 视 图 是 自动 更 新 的 。 


5.View1 的 界面 (演示 与 服务 端 交 互 ) 





页 面 位 置 : src/main/resources/static/views/view1.html. 


<div class="row"> 
«label for="attr" class="col-md-2 control-label"> 名 称 
</label> 
<div class="col-md-2"> 
<!-- 1 --> 
<input type="text"  class-"form-control" ng- 
model="personName"> 


</div> 
<div class="col-md-1"> 
<l-- 2 --> 


«button class="btn btn-primary" ng-click-"search()"»Zzrifj 
«/button» 


</div> 
</div> 


<div class="row"> 
<div class="col-md-4"> 
<ul class="list-group"> 
pis. io» 
«li class="list-group-item">% 
字 : {{person.name}}</1li> 
«li  class-"list-group-item"»/F 
i5:  {{person.age}}</li> 
«li class="list-group-item">i 
ht: {{person.address}}</1li> 
«/ul» 
</div> 
</div> 


代码 解释 
DE X AGERA ng-model=“personName” . 
@) 通 过 ng-click=“search O ”调用 控制 器 中 定义 的 方法 。 


(SB. ((person.name)). {{person.age}}. 
{{person.address}} 访 问 控制 器 的 scope 里 定义 的 person 模 型 ， 模 
型 和 视图 是 绑 定 的 。 


6. 服 务 端 代码 
传 值 对 象 Javabean: 


package com.wisely.ch7_7; 


public class Person { 
private String name; 
private Integer age; 
private String address; 


public Person() { 
super(); 


public Person(String name, Integer age, String address) { 
super(); 
this.name - name; 
this.age - age; 
this.address - address; 


j 
public String getName() { 
return name; 


public void setName(String name) ( 
this.name - name; 


} 
public Integer getAge() { 
return age; 


public void setAge(Integer age) { 
this.age = age; 


j 
public String getAddress() { 
return address; 


public void setAddress(String address) { 
this.address - address; 
} 


package com.wisely.ch7_7; 


import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootAppli 
import org.springframework.http.MediaType; 

import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RestController 


@RestController 


@SpringBootApplication 
public class Ch77Application { 


@RequestMapping(value="/search", produces= 
{MediaType .APPLICATION_JSON_VALUE} ) 
public Person search(String personName) { 
return new Person(personName, 32, "hefei"); 


j 


public static void main(String[] args) { 
SpringApplication.run(Ch77Application.class, args); 


代码 解释 


这 里 我 们 只 是 模拟 一 个 查询 ， 即 接受 前 台 传 入 的 
personName， 人 然后 返回 Person 类 ， 因 为 我 们 使 用 的 是 
@RestController， 且 返回 值 类 型 是 Person， 上 所 以 Spring MVC 会 
目 动 将 对 象 输出 为 JSON。 


7. 目 定义 指令 





脚本 位 置 : src/main/resources/static/js-action/directives.js: 


actionApp.directive( 'datePicker', function(){//1 
return { 
restrict: 'AC', //2 
link:function(scope,elem,attrs) { //3 
elem.datepicker();//4 


QD 定义 一 个 指令 名 为 datePicker。 
电 限 制 为 属性 指令 和 样式 指令 。 


(3) 使 用 link 方 法 来 定义 指令 ， 在 link 方 法 内 可 使 用 当前 
scope、 当 前 元 素 及 元 素 属 性 。 


初始 化 jqueryui 的 datePicker (jquery 的 写法 是 $ 
(‘#id’) .datePicker () ) 。 


通过 上 面 的 代码 我 们 就 定制 了 一 个 封装 jdqueryui 的 
datePickerH ie 本 例 只 是 为 了 演示 的 目的 ， 主 流 的 脚本 框 
染 已 经 被 很 多 人 封装 过 了 ， 有 兴趣 的 读者 可 以 访问 
http://ngmodules.org/ 网 站 ， 这 个 网 站 包含 了 大 量 AngularJS$ 的 第 
三 方 模块 、 插 件 和 指令 。 


8.View2 的 页 面 (演示 自 定义 指令 ) 











页 面 地 址 : src/main/resources/static/views/view2.html: 


<div class="row"> 
«label for="attr" class="col-md-2 control-label"> 属 性 形式 
</label> 
<div class="col-md-2"> 
les qd aoe 
<input type="text" class="form-control" date-picker> 
</div> 
</div> 





<div class="row"> 
«label for="style" class="col-md-2 control-label"> 样 式 形式 
</label> 
<div class="col-md-2"> 
«1-- 2 --» 
<input type="text" class-"form-control date-picker" > 
</div> 
</div> 





代码 解释 
(使 用 属性 形式 调用 指令 。 
@ 使 用 样式 形式 调用 指令 。 
9. 运 行 


琳 早 及 路 由 切换 如 图 7-39 所 示 。 














€ Q localhost:8080/action html lirective 
i ] 





图 7-39 KHN K A AC T 


与 后 台 交 互 如 网 7-40 所 示 。 








€ e localhost:8080/action 


地 址 : hefei 











图 7-40 ”与 后 台 交 互 
自 定 义 指令 如 图 7-41 所 示 。 


€ @ | [5 localhost:8080/action.html#/directive 


属性 形式 
样式 形式 | 
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图 7-41 上 自 定 义 指令 


第 8 革 Spring Boot 的 数据 访问 


Spring Data 项 目 是 Spring 用 来 解决 数据 访问 问题 的 一 揽 了 于 
解决 方案 ，Spring Data 是 一 个 伞 形 项 目 ， 包 含 了 大 量 关 系 型 数 
扼 库 及 非 关 系 型 数据 库 的 数据 访问 解决 方案 。Spring Data 使 我 
以 快速 且 简 单 地 使 用 普通 的 数据 访问 技术 及 新 的 数据 访问 


Spring Data 包 含 的 子 项 目 如 表 8-1 所 示 。 
表 8-1 SpringData 包 括 的 子 项 目 


项 目 名 称 Maven 坐标 
Spring Data JPA <dependency> 





<groupld>org.springframework.data</groupld> 

<artifactId>spring-data-jpa</artifactId> 

<version>1.8.1.RELEASE</version> 
</dependency> 





Spring Data MongoDB <dependency> 
«groupld»org.springframework.data«/groupld» 
«artifactId»spring-data-mongodb«/artifactId» 
«version» l.7. I. RELEASE«/version» 

</dependency> 





Spring Data Neo4J <dependency> 
<groupld>org.springframework.data</grouplId> 
«artifactId»spring-data-neo4j«/artifactId 
<version>3.3.1.RELEASE</version> 





</dependency> 


WAAR 


续 表 
Maven 坐标 





Spring Data Redis 


<dependency> 
<groupld>org.springframework.data</groupId> 
«artifactId»spring-data-redis«/artifactId» 
<version>1.5.1.RELEASE</version> 
</dependency> 





Spring Data Solr 


<dependency> 
«groupld»org.springframework.data«/groupId» 
«artifactId»spring-data-solr«/artifactId» 
<version>1.4.1.RELEASE</version> 
</dependency> 





Spring Data Hadoop 


<dependency> 
«groupld»org.springframework.data«/groupId» 
«artifactId»spring-data-hadoop«/artifactId» 
<version>2.2.0.RELEASE</version> 
</dependency> 





Spring Data GemFire 


<dependency> 
«groupld»org.springframework.data«/groupId» 
«artifactId» spring-data-gemfire «/artifactId» 
«version»1.6.1. RELEASE </version> 
«/dependency» 





Spring Data REST 


Spring Data JDBC Extensions 


«dependency» 
«groupld»org.springframework.data«/groupId» 
«artifactId»spring-data-rest-webmvc«/artifactId» 
<version>2.3.1.RELEASE</version> 

</dependency> 

<dependency> 
«groupId»org.springframework.data«/groupId» 
«artifactId»spring-data-oracle«/artifactId» 
«version». 1.0.RELEASE«/version 

</dependency> 





Spring Data CouchBase 





<dependency> 
«groupld»org.springframework.data«/groupId» 
«artifactId»spring-data-couchbase«/artifactId» 
«version» 1.3. l.:RELEASE«/version» 
</dependency> 


E rd 








Maven 坐标 











项 目 名 称 


Spring Data Elasticsearch 











<dependency> 
<groupld>org.springframework.data</groupId> 
<artifactId>spring-data-elasticsearch</artifactId> 
<version>1.2.1.RELEASE</version> 


</dependency> 





Spring Data Cassandra <dependency> 
<groupld>org.springframework.data</groupId> 
<artifactId>spring-data-cassandra</artifactId> 
<version>1.2.1.RELEASE</version> 

</dependency> 





Spring Data DynamoDB <repository> 
<id>opensourceagility-release</id> 
<url>http://repo.opensourceagility.com/release</url> 


</repository> 


<dependency> 
<groupId>org.socialsignin</groupId> 
<artifactId>spring-data-dynamodb</artifactld> 
<version>1.0.2.RELEASE</version> 





</dependency> 


Spring ”Data 为 我 们 使 用 统一 的 API 来 对 上 述 的 数据 存储 技 
术 进 行 数据 访问 操作 提供 了 文 持 。 这 是 Spring 通过 提供 Spring 
Data Commons 项 目 来 实现 的 ， 它 是 上 述 各 种 Spring Data 项 目的 
依赖 。Spring Data Commons 让 我 们 在 使 用 关系 型 或 非 关 系 型 
数据 访问 技术 时 都 使 用 基于 Spring 的 统一 标准 ， 该 标准 包含 
ree 1 获取 、 更 新 、 删 除 ) 、 碍 询 、 排 序 和 分 页 的 相 


此 处 介绍 下 Spring Data Commons 的 一 个 重要 概念 : Spring 
Data Repository 抽 象 。 使 用 Spring Data Repository n] LAIK K HEYR 
少数 据 访 问 层 的 代码 。 既 然 是 数据 访问 操作 的 统一 标准 ， 那 育 
定 是 定义 了 各 种 各 样 和 数据 访问 相关 的 接口 ，Spring Data 
Repository 抽 和 象 的 根 接口 是 Repository 接 口 : 








package org.springframework.data.repository; 
import java.io.Serializable; 
public interface Repository<T, ID extends Serializable> { 


j 





从 源码 中 可 以 看 出 ， 它 接受 领域 类 JPA 为 实体 类 )〉 和 领 
域 类 的 id 类 型 作为 类 型 参数 。 


它 的 子 接口 CrudRepository 定 义 了 和 CRUD 操 作 相 关 的 内 


T 


package org.springframework.data.repository; 
import java.io.Serializable; 
QNoRepositoryBean 
public interface CrudRepository<T, ID extends Serializable» e 
«S extends T» S save(S entity); 
«S extends T» Iterable<S> save(Iterable<S> entities); 
T findOne(ID id); 
boolean exists(ID id); 
Iterable<T> findAll(); 
Iterable<T> findAll(Iterable<ID> ids); 
long count(); 
void delete(ID id); 
void delete(T entity); 
void delete(Iterable<? extends T> entities); 
void deleteAll(); 


CrudRepositoryH) T-32 HO PagingAndSortingRepository4E X. f 
与 分 页 和 排序 操作 相关 的 内 容 : 


package org.springframework.data.repository; 
import java.io.Serializable; 

import org.springframework.data.domain.Page; 
import org.springframework.data.domain.Pageable; 
import org.springframework.data.domain.Sort; 


@NoRepositoryBean 

public interface PagingAndSortingRepository<T, ID extends Ser 
Iterable<T> findAll(Sort sort); 
Page<T> findAll(Pageable pageable); 





不 同 的 数据 访问 技术 也 提供 了 不 同 的 Repository， 如 Spring 
Data JPA 有 JpaRepository、Spring Data MongoDB 有 
MongoRepository. 


Spring Data 项 目 还 给 我 们 提供 了 一 个 激动 人 心 的 功能 ， 
可 以 根据 属性 名 进行 计数 、 删 除 、 碍 询 方法 等 操作 ， 例 如 : 











public interface PersonRepository extends Repository<Person, 
// 按 照 年 龄 计数 
Long countByAge(Integer age); 
// 按 照 名 字 删 除 
Long deleteByName(String name); 
// 按 照 名 字 查 询 
List<Person> findByName(String name); 
// 按 照 名 字 和 地 址 查询 
List<Person> findByNameAndAddress(String name,String addr 


我 们 将 在 8.2 节 对 Spring Data 提 供 的 简化 数据 访问 操作 进行 
更 为 详细 的 讲解 。 


本 章 将 学 习 Spring Data JPA. Spring Data MongoDB、 
Spring Data REST. Spring Data Redis。 通 过 对 这 些 Spring Data 
项 目的 学 习 ， 并 按照 Spring Data 提 供 的 统一 标准 ， 当 你 有 需要 
的 时 候 ， 也 会 快速 掌握 Spring Data 的 其 他 项 目 。 


8.1 5| ADocker 


大 家 也 许 很 奇怪 为 什么 本 书 在 此 处 要 引入 Docker，Docker 
究竟 是 什么 ， 它 能 干什么 ? 


Docker 这 两 年 大 受 奶 捧 ， 风 光 无 二 。Docker 是 一 个 轻 量 级 
容 右 技术 ， 类 似 于 虚拟 机 技术 (xen, kvm, vmware, 
virtual) 。Docker 是 直接 运行 在 当前 操作 系统 (Linux) 之 上 ， 
而 不 是 运行 在 虚拟 机 中 ， 但 是 也 实现 了 虚拟 机 技术 的 资源 隔 
离 ， 性 能 远 远 高 于 虚拟 机 技术 。 


Docker 文 持 将 软件 编译 成 一 个 镜像 (image) ， 在 这 个 镜像 
里 做 好 对 软件 的 各 种 配置 ， 然 后 发 布 这 个 镜像 ， 使 用 者 可 以 运 
行 这 个 镜像 ， 运 行 中 的 镜像 称 之 为 容器 (container) ， 容 器 的 
启动 是 非常 快 的 ， 一 般 都 是 以 秒 为 单位 。 这 个 有 点 像 我 们 平时 
安装 ghost 操 作 系 统 ? 系统 安装 好 后 软件 都 有 了 ， 虽 然 完 全 不 
是 一 种 东西 ， 但 是 思路 是 类 似 的 。 


目前 各 大 主流 云 计 算 平 台 都 文 持 Docker 容 器 技术 ， 包 括 阿 
里 云 、 百 度 云 平台 (资源 隔离 通过 Docker 实 现 ) ~ Cloud 
Foundry( 和 Spring 一 家 公司 的 ， 目 前 最 成 熟 也 最 稳定 )、 
HeroKu、DigitalOcean、OpenShift (JBoss 的 ) ~ Apache 
Stratos. Apache MesOS〔( 批 处 理 平 台 ， 支 持 搭建 基于 Docker 的 
BE a) ~ Deis (开源 PaaS 平 台 〉; 连 微 软 也 会 在 下 一 个 版 本 
的 Windows ”Server 及 其 云 平台 Azure 上 支持 Docker， 这 样 看 来 
Docker 大 有 统一 云 计 算 的 趋势 。 


这 里 的 云 计算 平台 一 般 指 的 是 PaaS 平台 即 服务 ) ， 它 是 
一 个 这 样 的 云 计算 : 平台 提供 了 存储 、 数 据 库 、 网 络 、 人 负载 均 















































衡 、 目 动 扩 展 等 功能 ， 你 只 需 将 你 的 程序 交 给 云 计 算 平 台 就 可 
以 了 。 你 的 程序 可 以 是 用 不 同 的 编程 语言 开发 的 ， 而 使 用 的 
Docker 的 云 计 算 平 台 就 是 用 Docker 来 实现 以 上 功能 及 不 同 程序 
之 间 的 隔离 的 。 


目前 主流 的 软件 以 及 非 主 流 的 软件 大 部 分 都 有 人 将 其 封装 
成 Docker 镑 像 ， 我 们 只 需 下 载 Docker 镜 像 ， 然 后 运行 镜像 就 可 
以 快速 获得 已 做 好 配置 可 运行 的 软件 。 


从 本 章 开 始 ， 我 们 的 数据 库 将 使 用 Oracle XE. iR 
Redis 作 为 缓存 和 NoSQL 数 据 库 的 演示 、 需 安装 MongoDB 进 行 
NoSQL Zi fis PE 18 zn o 


在 第 9 章 需 要 安装 ActiveMQ 以 及 RabbitMQ 进 行 异 步 消 息 的 
演示 。 在 第 10 章 我 们 会 演示 基于 Docker 的 Spring Boot 的 部 署 。 
使 用 Docker 后 我 们 将 不 用 手动 下 载 、 安 装 和 配置 这 些 软件 。 


另外 要 特别 指出 的 是 ，Docker 并 不 是 为 开发 测试 方便 而 提 
供 的 小 工具 ， 而 是 可 以 用 于 实际 生产 环境 的 一 种 极 好 的 部 署 方 


A. 


当然 ， 如 果 你 觉得 目前 没有 迫切 学 习 Docker 的 必要 ， 可 以 
略 过 此 节 ， 并 上 自行 下 载 安装 本 书 示例 中 所 需要 的 软件 ， 不 过 这 
么 简单 易 用 的 技术 还 是 强烈 建议 学 习 一 下 。 


当然 ， 本 书 中 涉及 的 Docker 内 容 主 要 是 为 了 方便 我 们 开发 
测试 所 需 安 装 的 软件 ， 不 会 涉及 Docker 所 有 的 内 容 ， 当 然 也 不 
失 于 学 习 Docker 入 门 的 好 材料 。 通 过 学 习 本 书 的 Docker 内 容 ， 
可 以 快速 入 门 Docker， 然 后 按照 自己 的 需求 看 是 否 需 要 继续 深 
ee 





















































8.1.4 Docker 的 安装 





因为 Docker 的 运行 原理 是 基于 Linux 的 ， 所 以 Docker 只 能 在 
Linux 下 运行 。 不 要 紧张 ， 这 只 能 说 明 在 真正 的 生产 环节 下 ， 
基于 Docker 的 部 署 只 能 在 Linux 上 ， 但 是 我 们 在 开发 测试 的 时 
候 ，Docker 是 可 以 在 Windows 以 及 Mac OS X 系 统 下 的 ， 运 行 的 
原理 是 启动 一 个 VirtualBox 虚 拟 机 ， 在 此 虚拟 机 里 运行 
Docker。 








1.Linux 下 安装 
1H 


CentOS Z 3 in 4: 


sudo yum update 
sudo yum install docker 


Ubuntu: 


sudo apt-get update 
sudo apt-get docker.io 


2.Windows F Ze 


Windows 下 运行 Docker 是 通过 这 个 Boot2Docker 这 个 软件 来 
实现 的 ， 这 个 软件 包含 了 一 个 VirtualBox。 在 Windows 下 的 
Docker 只 适合 于 开发 测试 ， 不 适合 于 生产 环境 。 


Boot2Docker 下 载 地 址 : 


https://github.com/boot2docker/windows-installer/releases/latest . 





因 在 Windows 下 运行 的 Docker 是 基于 VirtualBox 虚 拟 机 软 
件 ， 因 此 在 安装 前 请 确认 电脑 的 BIOS 设 置 中 的 CPU 虚 拟 化 技 
术 支 持 已 经 开启 。 





在 我 们 目前 测试 的 版 本 (1.7.0) 中 ，Boot2Docker 和 暂时 不 支 
持 Windows 10 系 统 。 


双击 docker-install.exe 开 始 安装 ， 如 图 8-1 所 示 。 


@ Setup - Boot2Docker for Windows onl Loe 





Select Destination Location > 
Where should Boot2Docker for Windows be installed? 
docker 


k Setup will install Boot2Docker for Windows into the following folder. 


To continue, click Next. If you would like to select a different folder, click Browse. 


Browse... 





c: Program Files\Boot2Docker for Windows 


Atleast 1.4 MB of free disk space is required. 








Boot2Docker for Windows installation documentati (=< Backa) Next >] 





图 8-1 开始 安装 


选择 完整 安装 ， 其 中 ，MSYS-git UNIX tools 是 在 Windows 
下 运行 UNIX (Linux) 命令 的 工具 ， 如 图 8-2 所 示 。 


ffi Setup - Boot2Docker for Windows 00000000 [e| - mS] 


Select Components 
Which components should be installed? 


docker 





Select the components you want to install; dear the components you do not want to 
install, Click Next when you are ready to continue. 











Boot2Docker management tool and ISO 
[V] VirtualBox 
V] MSYS-git UNIX tools 




















Current selection requires at least 140.6 MB of disk space. 


Boot2Docker for Windows installation documentatio uu Back JL neto.) 








Kla-2 ”完整 安装 


勺 选 “Reboot Windows at end of installation (选择 安装 完成 
后 重启 电脑 ) ”选项 ， 如 图 8-3 所 示 。 


ffi Setup - Boot2Docker for Windows if 00) wee ol m 


Select Additional Tasks 
Which additional tasks should be performed? 








Select the additional tasks you would like Setup to perform while installing Boot2Docker 
for Windows, then click Next. 


[V] Add docker.exe/boot2docker.exe to PATH 


V| Reboot Windows at the end of installation 











Boot2Docker for Windows installation Eee 


图 8-3” 勾 选 “Reboot Windows at the end of installation (安装 完成 后 重启 
电脑 ) 选项 


安装 “通用 串 行 总 线 控制 器 >”， 如 图 8-4 所 示 。 
E Windows® OOOO 


您 想 安 装 这 个 设备 软件 吗 ? 


名 称 : Oracle Corporation BASTA 
e 发 布 者 ; Oracle Corporation 








| @ 您 应 仅 从 可 信 的 发 布 者 安装 驱动 程序 软件 。 我 如 何 确定 器 些 设备 软件 可 以 安全 空 闭 ? 


图 8-4 ”安装 “通用 串 行 忆 控制 占 ” 


安装 完成 后 ， 自 动 重 启 电脑 。 启 动 Docker， 选 择 桌 面 图 标 
Boot2Docker Start， 如 图 8-5 所 示 。 














图 8-5 srt Él b Boot2Docker Start 


B 安装 成 功 验证 ， 输 入 下 面 命令 验证 Docker 厂 本 ， 如 图 8-6 所 
2s 


docker -v 


á MINGW32:/c/Users/wisely 


export DOCKER CERT. PATH** - 0 ocker 
export DOCKEK ILS UERIFY-1 


Ncerts \bhoot2 


2 of docker UM: 
-99.103 


ting sironnent 
Writing Wise wi 
Writing CsNise wise lys. 
Writing sers ‘wisely. 


oxy DOCKER HC tep 
export DOCKER CERT, PATH ; ser elywr. )c ker sSNcertz \\hoot2docker 


vot 2ducher-ve\ca. pen 
vhoot2docher-un t.pen 


pe 2docker vn ey.pen 


export DOCKFR TLS UFRIFV-1 


You can now use ‘docker direct] or ‘hoot2docher sash* to log into the UM. 


lelcome to Git Cversion 1.9.5 preview28150319) 


Run “git help git’ to display the help index. 


Run ’git help <cammand>’ to display help for apecifie commands. 


docker -v 


Docker version 1.7 build Ubaf6uy 





图 8-6 ”验证 Docker 版 本 


此 时 VirtualBox 运 行 了 一 个 虚拟 机 。 打 开 VirtualBox 软 件 ， 
如 图 8-7 所 示 。 


(ERD) ) dà gib eaa] 


Am oss 








ÉKl8-7 VirtualBox &fF 


8.1.2 ”Docker 常用 命令 及 参数 


1.Docker 镜 像 命令 


基于 Docker 镜 像 是 可 以 目 己 编译 的 ， 我 们 将 在 10.3 节 讲解 
如 何 编译 自己 的 Docker 镜 像 ， 本 节 我 们 讲述 与 Docker 镜 像 操 作 
相关 的 命令 。 


通 沼 情况 下 ，Docker 的 镜像 部 放置 在 Docker 官 网 的 Docker 
Hub 上 上 ， 地 址 是 https://registry.hub.docker.com， 如 图 8-8 所 示 。 








&@ redis ubuntu? l QW wouopeess 


MySQL - &* CentOS 


NGINX « 


图 8-8 Docker Hub 
(1) Docker& ff Ky zx 


除了 可 以 在 https://registry.hub.docker.com 网 站 检索 镜像 以 
外 ， 还 可 以 用 下 面 命 令 检 索 : 


nede: 











docker search 镜像 名 


检索 Redis， 输 入 : 


docker search redis 


(2) 镜像 下 载 
下 载 镜 像 通过 下 面 命令 实现 : 


docker pull 镜像 名 


下 载 Redis 镜 像 ， 运 行 : 
docker pull redis 


这 根据 据 网 络 情况 可 能 要 花费 一 段 时 间 。 


(3) 镜像 列表 
查看 本 地 镜像 列表 ， 如 图 8-9 所 示 ， 通 过 下 面 命令 : 


docker images 





redis 





图 8-9 ”镜像 列表 


其 中 REPOSITORY 是 镜像 名 ; TAG 是 软件 版 本 ，latest 为 最 
thik; IMAGE ID 是 当前 镜像 的 唯一 标识 : CREATED 是 当前 
镜像 创建 时 间 ; VIRTUAL SIZE 是 当前 镜像 的 大 小 。 


(4) 镜像 删除 
删除 指定 镜像 通过 下 面 命令 : 


docker rmi image-id 


删除 所 有 镜像 通过 下 面 命令 : 


docker rmi $(docker images -q) 


nj 


2.Docker 48 áp & 
(1) 容器 基本 操作 
最 简单 的 运行 镜像 为 容 右 的 命令 如 下 : 





docker run --name container-name -d image-name 


运行 一 个 容器 只 要 通过 Docker run 命 令 即 可 实现 ， 其 中 ， 
name 参 数 是 为 容器 取得 名 称 ;，-d 表 示 detached， 意 味 着 执行 完 
这 人 句 命 令 后 控制 台 将 不 会 被 阻碍 ， 可 继 绢 令 操 作 ; 最 后 
的 image-name 是 要 使 用 哪个 镜像 来 运行 容器 


我 们 来 运行 一 个 Redis 容 丹 : 








docker run --name test-redis -d redis 


Docker 会 为 我 们 的 容器 生成 唯一 的 标识 。 
(2) 容器 列表 
通过 下 面 命令 ， 查 看 运行 中 的 容器 列表 ， 如 图 8-10 所 示 。 


docker ps 





图 8-10 ”容器 列表 


其 中 CONTAINER ID 是 在 启动 的 时 候 生成 的 ID; IMAGE 





是 该 容器 使 用 的 镜像 ，COMMAND 是 容器 启动 时 调用 的 命 
4: CREATED 是 容器 创建 时 间 ; STATUS 是 当前 容器 的 状 
A; PORTS 是 容器 系统 所 使 用 的 端口 号 ，Redis 默 认 使 用 6379 
端口 ，NAMES 是 刚才 给 容 右 定义 的 名 称 。 


通过 下 列 命令 可 查看 运行 和 停止 状态 的 容 兹 : 








docker ps -a 


(3) 停止 和 启动 容器 
12 ikea 


FE IE ROSE PAA Ar: 


docker stop container-name/container-id 





我 们 可 以 通过 容器 名 称 或 者 容器 id 来 停止 容器 ， 以 停止 上 
面 的 Redis 容 器 为 例 : 


docker stop test-redis 





此 时 运行 中 的 容器 列表 为 空 。 查 看 所 有 容器 命令 ， 可 看 出 
此 时 的 STATUS 为 退出 。 


2) 启动 容器 


司 动容 占 通 过 下 面 命令 : 


docker start container-name/container-id 


再 次 月 动 我 们 刚才 俘 止 的 容器 ; 


docker start test-redis 


此 时 查看 容器 列表 如 图 8-11 所 示 。 


docker start test-redis 








NAMES 





图 8-11 ”启动 刚才 停止 的 容器 
3) 端口 映射 


Docker 容 器 中 运行 的 软件 所 使 用 的 端口 ， 在 本 机 和 本 机 的 
局 域 网 是 不 能 访问 的 ， 所 以 我 们 需要 将 Docker 容 器 中 的 端口 映 
射 到 当前 主机 的 端口 上 ， 这 样 我 们 在 本 机 和 本 机 所 在 的 局 域 网 
就 能 够 访问 该 软件 了 。 

Docker 的 端口 映射 是 通过 一 个 -p 参 数 来 实现 的 。 我 们 以 刚 
才 的 Redis 为 例 ， 映 射 容器 的 6379 端 口 到 本 机 的 6378 端 口 ， 命 
SUF: 





docker run -d -p 6378:6379 --name port-redis redis 





目前 在 Windows 下 运行 的 Docker 其 实 是 运行 在 VirtualBox 虚 
拟 机 中 的 ， 即 我 们 当前 的 本 机 并 个 十 我 们 当前 的 开发 机 器， 而 
是 VirtualBox 虚 拟 机 ， 所 以 我 们 还 需要 再 做 一 次 端口 映射 ， 将 
VirtualBox 虚 拟 的 端口 映射 到 当前 的 开发 机 器 。 这 部 分 内 容 将 
在 实际 部 车 软件 的 时 候 进 行 演示 。 


4) 删除 容器 
ARENAS, AR AS: 





docker rm container-id 


docker rm $(docker ps -a -q) 


) 容器 日 志 


fuh HAMAS, np Pm: 








docker logs container-name/container-id 





我 们 查看 下 上 面 一 个 容器 的 日 志 ， 如 图 8-12 所 示 ， 命 令 如 


docker logs port-redis 

















图 8-12 ”容器 的 日 志 
6) 登录 容器 


运行 中 的 容器 其 实 是 一 个 功能 完备 的 Linux 操 作 系 统 ， 所 以 
我 们 可 以 像 常规 的 系统 一 样 登录 并 访问 容器 。 

我 们 可 以 使 用 下 面 命令 ， 登 录 访问 当前 容器 ， 登 录 后 我 们 
可 以 在 容器 中 进行 常规 的 Linux 系 统 操 作 命令 ， 还 可 以 使 用 exit 
命令 退出 登录 。 





docker exec -it container-id/container-name bash 


8.3 下载 本 书 所 需 的 Docker 镜 像 


有 些 需 要 下 载 的 镜像 还 是 比较 大 的 ， 所 以 在 此 处 先 下 载 下 
来 ， 以 备 后 面 使 用 。 





Oracle xe. MongoDB, Redis, #ActiveMQRabbit MQ 以 及 
THA E ER FIEL AN RabbitMQIT] Ha 2) HI GN: RabbitMQ 以 及 市 
有 管理 界面 的 RabbitMQ: 


docker pull wnameless/oracle-xe-11g 
docker pull mongo 

docker pull redis:2.8.21 

docker pull cloudesire/activemq 
docker pull rabbitmq 

docker pull rabbitmq:3-management 


下 载 完 成 后 ， 查 看 Docker 镜 像 列 表 ， 如 8-13 所 示 。 


f5d621561b07 ja a 
8d79c535f2e4 jays ago 109.2 MB 


Ta92d3b54aee jays ago 143.7 MB 
85b590597F95 weeks ago 143.5 MB 
aTbOlfTlaf86 weeks ago 260.8 MB 
0803d654ebc69 weeks ago 2.241 GB 


图 8-13 ”Docker 镜 像 列表 





8.1.4 ”异常 处 理 


若 出 现 命令 不 能 执行 的 错误 ， 则 直接 使 用 下 面 命令 登录 
VirtualBox 虚 拟 机 执行 命令 : 


boot2docker ssh 





在 登录 虚拟 机 后 ， 表 执行 常规 命令 ， 如 图 8-14 所 示 。 





@ MINGW32:/c/Users/wisely 


$ boot2docker ssh 
HH 
HH HH HH 
HH HH HH HH 


Boot2Docker version 1.7.0, 
Docker version 1.7.0, buil 
docker@boot2docker :~$ dock 
REPOSITORY 

redis 

rabbitmq 

mongo 
wnameless/oracle-xe-119 
webcenter/activemq 
docker@boot2docker : ~$ 


build master 


d Obaf609 
er images 
TAG 
2.8.21 
latest 
latest 
latest 
latest 


IMAGE ID 

8d79c535f2e4 
85b590597F95 
a7b01f71af86 
O803d64ebc69 
O46ed760d1b1 


CREATED 

2 days ago 
12 days ago 
12 days ago 
3 weeks ago 
6 months ago 























登录 虚拟 机 








8.2 Spring Data JPA 


8.2.1 点睛 Spring Data JPA 


1. 什 么 是 Spring Data JPA 


在 介绍 Spring Data JPA 的 时 候 ， 我 们 首先 认识 下 
Hibernate。Hibernate 是 数据 访问 解决 技术 的 绝对 霸主 ， 使 用 
O/R 映 射 CObject-Relational Mapping) 技术 实现 数据 访问 ， 
O/R 映 射 即将 领域 模型 类 和 数据 库 的 表 进 行 映射 ， 通 过 程序 操 
作对 象 而 实现 表 数 据 操作 的 能 力 ， 让 数据 访问 操作 无 顷 关 注 数 
据 库 相关 的 技术 。 


随 着 Hibernate 的 盛行 ，Hibernate 主 导 了 EJB ”3.0 的 JPA 规 
范 ，JPA 即 Java Persistence API。JPA 是 一 个 基于 O/R 映 射 的 标 
准 规范 (目前 最 新 版 本 是 JPA 2.1) 。 所 谓 规范 即 只 定义 标准 
规则 (如 注解 、 接 口 )， 不 提供 实现 ， 软 件 提 供 商 可 以 按照 标 
准 规范 来 实现 ， 而 使 用 者 只 需 按 照 规 范 中 定义 的 方式 来 使 用 ， 
而 不 用 和 软件 提供 商 的 实现 打交道 。JPA 的 主要 实现 由 
Hibernate、EclipseLink 和 OpenJPA 等 ， 这 也 意味 着 我 们 只 要 使 
用 JPA 来 开发 ， 无 论 是 哪 一 个 开发 方式 都 是 一 样 的 。 

Spring Data JPA 是 Spring Data 的 一 个 子 项 目 ， 它 通过 提供 
基于 JPA 的 Repository 极 大 地 减少 了 JPA 作 为 数据 访问 方案 的 代 
但 量 。 

2. 定 义 数 据 访问 层 

使 用 Spring Data JPA 建 立 数据 访问 层 十 分 简单 ， 只 需 定义 


























一 个 继承 JpaRepository 的 接口 即 可 ， 定 义 如 下 : 


public interface PersonRepository extends JpaRepository<Perso 
// 定 义 数 据 访问 操作 的 方法 








} 





继承 JpaRepository 接 口 意 味 着 我 们 默认 已 丝 有 了 下 面 的 数 
据 访 问 操作 方法 : 


@NoRepositoryBean 
public interface JpaRepository<T, ID extends Serializable> ex 
List<T> findAll(); 
List<T> findAll(Sort sort); 
List<T> findAll(Iterable<ID> ids); 
<S extends T> List<S> save(Iterable<S> entities); 
void flush(); 
«S extends T» S saveAndFlush(S entity); 
void deleteInBatch(Iterable<T> entities); 
void deleteAllInBatch(); 
T getOne(ID id); 


} 
3. 配 置 使 用 Spring Data JPA 
在 Spring 环 境 中 ， 使 用 Spring Data JPA 可 通过 


@EnableJpaRepositories 注 解 来 开 司 Spring Data JPA 的 文 持 ， 
@EnableJpaRepositories 接 收 的 value 参 数 用 来 扫描 数据 访问 层 
所 在 包 下 的 数据 访问 的 接口 定义 。 





@Configuration 
QEnableJpaRepositories("com.wisely.repos") 
public class JpaConfiguration ( 
QBean 
public EntityManagerFactory entityManagerFactory() { 
//... 


// 还 需 配置 DataSource、PlatformTransactionManager 等 相关 必须 
bean 


4. 定 义 查 询 方法 

在 讲解 查询 方法 前 ， 假 设 我 们 有 一 张 数 据 表 叫 PERSON， 
有 ID (Number) 、NAME (Varchar2) 、AGE (Number) 、 
ADDRESS (Varchar2) 几 个 字段 ;对 应 的 实体 类 叫 Person， 分 
别 有 id (Long) 、name (String) 、age (Integer) 、 
address (String) 。 下 面 我 们 就 以 这 个 简单 的 实体 查询 作 为 演 
示 。 








(1) 根据 属性 名 俘 询 


Spring Data JPA 文 持 通过 定义 在 Repository 接 口中 的 方法 名 
来 定义 查询 ， 而 方法 名 是 根据 实体 类 的 属性 名 来 确定 的 。 


D 常规 查询 。 根 据 属 性 名 来 定义 伍 询 方法 ， 示 例如 下 : 























public interface PersonRepository extends JpaRepository<Perso 


/** 
* 


* 通过 名 字 相 等 查询 ， 参 数 为 name 

* 相当 于 JPQL:select p from Person p where p.name=?1 
we 

List<Person> findByName(String name); 


/** 
* 


* 通过 名 字 11ke 查 询 ， 参 数 为 name 
* 相当 于 JPQL: select p from Person p where p.name like ? 


*/ 
List<Person> findByNameLike(String name); 
/** 


* 


* 通过 名 字 和 地 址 查询 ,参数 为 name 和 address 


* 相当 于 JPQL: select p from Person p where p.name=? 
1 and p.address=?2 
*/ 
List<Person> findByNameAndAddress(String name,String addr 


从 代码 可 以 看 出 ， 这 里 使 用 了 findBy、Like、And 这 样 的 关 
键 字 。 其 中 findBy 可 以 用 find、read、readBy、gquery、 
queryBy. get. getByK{t. 


而 Like 和 and 这 类 查询 关键 字 ， 如 表 8-2 所 示 : 
表 8-2 ”查询 关键 字 













































































关键 字 m 例 同 功 能 JPQL 
And findByLastnameAndFirstname where x.lastname = ?1 and x.firstname = ?2 
Or findByLastnameOrFirstname where x.lastname = ?1 or x.firstname = ?2 
Is,Equals findByFirstname,findByFirstnamels,findBy where x.firstname = 1? 

FirstnameEquals 

Between findByStartDateBetween where x.startDate between 1? and ?2 
LessThan findByAgeLessThan where x.age < ?1 
LessThanEqual findByAgeLessThanEqual where x.age = ?1 
GreaterThan findByAgeGreaterThan where x.age > ?1 
GreaterThanEqual findByA geGreaterThanEqual where x.age >= ?1 
After findByStartDateAfter where x.startDate > ?1 
Before findByStartDateBefore where x.startDate « ?1 
IsNull findByAgelsNull where x.age is null 
IsNotNull, NotNull findByAge(Is)NotNull where x.age not null 
Like findByFirstnameLike where x.firstname like ?1 
NotLike findByFirstnameNotLike where x.firstname not like ?1 
StartingWith findByFirstnameStartingWith where x.firstname like ?1 (参数 前 面 加 %) 
EndingWith findByFirstnameEndingWith where x.firstname like ?1 (参数 后 面 加 96) 
Containing findByFirstnameContaining where x.firstname like ?1 (参数 两 边 加 %) 
OrderBy findByAgeOrderByLastnameDesc if where x.age = ?1 order by x.lastname desc 
Not findByLastnameNot where x.lastname <> ?1 
In findByA geln(Collection<Age> ages) where x.age in ?1 
NotIn findByA geNotIn(CollectioncAge» age) where x.age not in ?1 
True findByActiveTrue() where x.active — true 
False findByActiveFalse() where x.active — false 
IgnoreCase findByFirstnamelgnoreCase where UPPER(x.firstame) = UPPER(?1) 


2) 限制 结果 数量 。 结 果 数量 是 用 top 和 first 关 键 字 来 实现 
Hy, Wan: 


public interface PersonRepository extends JpaRepository<Perso 


/** 
* 


* 获得 符合 查询 条 件 的 前 10 条 数据 

* 

*/ 

List<Person> findFirst10ByName(String name); 





/** 
* 
* RATS AWR 30K Bia 
* 
*/ 


List<Person> findTop30ByName(String name); 


(2) 使 用 JPA 的 NamedQuery 碍 询 





Spring Data JPA 支 持 用 JPA 的 NameQuery 来 定义 查询 方法 ， 
即 一 个 名 称 映射 一 个 查询 语句 。 定 义 如 下 : 





@Entity 
@NamedQuery(name = "Person.findByName", 

query = "select p from Person p where p.name=?1") 
public class Person { 


j 


使 用 如 下 语句 : 


public interface PersonRepository extends JpaRepository<Perso 
[rs 


* 


* 这 时 我 们 使 用 的 是 NamedQuery 里 定义 的 查询 语句 ， 而 不 是 根据 方法 名 称 








* 
*/ 
List<Person> findByName(String name); 


(3) 使 用 @Query 查 询 


1) 使 用 参数 索引 。Spring Data JPA 还 支持 用 @Query 注 解 
在 接口 的 方法 上 实现 查询 ， 例 如 : 


public interface PersonRepository extends JpaRepository<Perso 
QQuery("select p from Person p where p.address=?1") 
List«Person» findByAddress(String address); 


2) 使 用 命名 参数 。 上 面 的 例子 是 使 用 参数 的 索引 号 来 查 
询 的 ， 在 Spring Data JPA 里 还 文 持 在 语句 里 用 名 称 来 匹配 得 询 
参数 ， 例 如 : 








public interface PersonRepository extends JpaRepository<Perso 
@Query("select p from Person p where p.address= :address" 
List<Person> findByAddress(@Param("address") String addre 


3) 更 新 查询 。Spring Data JPA x fr(2Modityingfill Query 
注解 组 合 来 事件 更 新 查询 ， 例 如 : 


public interface PersonRepository extends JpaRepository<Perso 


@Modifying 

@Transactional 
@Query("update Person p set p.name=?1") 
int setName(String name); 


其 中 返回 值 int 表 示 更 新 语句 影响 的 行 数 。 
(4) Specification 


JPA 提 供 了 基于 准则 查询 的 方式 ， 即 Criteria 查 询 。 而 Spring 
Data JPA 提 供 了 一 个 Specification CHEE) 接口 让 我 们 可 以 更 方 
便 地 构造 准则 查询 ，Specification 接 口 定 义 了 一 个 toPredicate 方 
法 用 来 构造 查询 条 件 。 


D 定义 。 我 们 的 接口 类 必需 实现 JpaSpecificationExecutor 





public interface PersonRepository extends JpaRepository<Perso 


JpaSpecificationE 


然后 需要 定义 Criterial 查 询 ， 代 人 码 如 下 : 


import javax. 
import javax. 
import javax. 
import javax. 


persistence. 
persistence. 
persistence. 
persistence. 


criteria. 
criteria. 
criteria. 
criteria. 


CriteriaBuilder; 
CriteriaQuery; 
Predicate; 

Root; 


import org.springframework.data.jpa.domain.Specification; 


import com.wisely.domain.Person; 


public class CustomerSpecs ( 


public static Specification«Person» personFromHefei() ( 
return new Specification<Person>() { 


@Override 
public Predicate toPredicate(Root<Person> root, C 


> query, CriteriaBuilder cb) { 


return cb.equal(root.get("address"), "4 





JE"); 


HH 








我 们 使 用 Root 来 获得 需要 查询 的 属性 ， 通 过 CriteriaBuilder 
构造 查询 条 件 ， 本 例 的 含义 是 查 出 所 有 来 自 合 肥 的 人 。 


注意 : CriteriaBuilder、CriteriaQuery、Predicate、Root 都 是 


来 自 JPA 的 接口 。 


CriteriaBuilder 包 含 的 条 件 构造 有 : exists. and. or. not. 
conjunction, disjunction, isTrue. isFalse. isNull. isNotNull, 
equal. notEqual. greaterThan, greaterThanOrEqualTo., 
lessThan、lessThanOrEqualTo、between 等 ， 详 细 请 查看 
CriteriaBuilder 的 API。 


2) 使 用 。 静 态 导 








import static com.wisely.specs.CustomerSpecs.*; 


注入 personRepository 的 Bean 后 : 


List<Person> people = personRepository.findAll(personFromHefe 


(5) FER Sam 
Spring Data JPA 充 分 考虑 了 在 实际 开发 中 所 必需 的 排序 和 





分 页 的 场景 ， 为 我 们 提供 了 Sort 类 以 及 Page 接 口 和 Pageable 接 
Ele 


1) 定义 : 


package com.wisely.repos; 

import java.util.List; 

import org.springframework.data.domain.Page; 

import org.springframework.data.domain.Pageable; 

import org.springframework.data.domain.Sort; 

import org.springframework.data.jpa.repository.JpaRepository; 
import org.springframework.data.jpa.repository.Modifying; 
import org.springframework.data.jpa.repository.Query; 

import org.springframework.data.repository.query.Param; 
import com.wisely.domain.Person; 

public interface PersonRepository extends JpaRepository<Perso 


List<Person> findByName(String name,Sort sort); 
Page<Person> findByName(String name, Pageable pageable); 


2) 使 用 排序 : 


List<Person> people = personRepository.findByName("xx", new S 


3) 使 用 分 页 ; 


Page<Person> people2 = personRepository.findByName("xx", new 


其 中 Page 接 口 可 以 获得 当前 页 面 的 记录 、 总 页 数 、 总 记录 





数 、 是 否 有 上 一 页 或 下 一 页 等 。 

5. 自 定义 Repository 的 实现 

Spring Data 提 供 了 和 CrudRepository、 
PagingAndSortingRepository; Spring Data JPA 也 提供 了 
JpaRepository。 如 果 我 们 想 把 自己 常用 的 数据 库 操作 封装 起 


来 ， 像 jpaRepository 一 样 提 供给 我 们 领域 类 的 Repository 接 口 使 
用 ， 应 该 怎么 操 做 呢 ? 


(1) 定义 目 定 义 Repository 接 口 : 





@NoRepositoryBean//1 
public interface CustomRepository<T, ID extends Serializable> 


public void doSomething(ID id);//3 


代码 解释 


(D@NoRepositoryBean 指 明 当 前 这 个 接口 不 是 我 们 领域 类 
的 接口 (如 PersonRepository。 





我 们 自 定义 的 Repository 实 现 PagingAndSortingRepository 
接口 ， 有 具备 分 页 和 排序 的 能 力 。 


要 定义 的 数据 操作 方法 在 接口 中 的 定义 。 
(2) 定义 接口 实现 : 








public class CustomRepositoryImpl «T, ID extends Serializable 
extends SimpleJpaRepository<T, ID» imple 


private final EntityManager entityManager;//2 


public CustomRepositoryImpl(Class«T» domainClass, EntityM 
super(domainClass, entityManager); 
this.entityManager - entityManager; 


} 
@Override 
public void doSomething(ID id) { 
// 4 
} 
} 
代码 解释 


QD 首先 要 实现 CustomRepository 接 口 ， 继 承 
SimpleJpaRepository 类 让 我 们 可 以 使 用 其 提供 的 方法 《如 
findAll) 。 


地 让 数据 操作 方法 中 可 以 使 用 entityManager。 


(3)CustomRepositoryImpl 的 构造 函数 ， 需 当前 处 理 的 领域 类 
类 型 和 entityManager 作 为 构造 参数 ， 在 这 里 也 给 我 们 的 
entityManager 赋 值 了 。 


在 此 处 定义 数据 访问 操作 ， 如 调用 findAll 方 法 并 构造 一 
些 碍 询 条 件 。 


(3) 自 定义 RepositoryFactoryBean。 自 定义 
JpaRepositoryFactoryBean 蔡 代 默 认 RepositoryFactoryBean， 我 
们 会 获得 一 个 RepositoryFactory，RepositoryFactory 将 会 注册 我 
们 自 定义 的 Repository 的 实现 : 


public class CustomRepositoryFactoryBean<T extends JpaReposit 


extends JpaRepositoryFactoryBean<T, S, ID> {// 1 


@Override 

protected RepositoryFactorySupport createRepositoryFactor 
return new CustomRepositoryFactory(entityManager ) ; 

} 


private static class CustomRepositoryFactory extends JpaR 


public CustomRepositoryFactory(EntityManager entityMa 
super(entityManager); 


QOverride 
@SuppressWarnings({"unchecked"} ) 
protected <T, ID extends Serializable> SimpleJpaRepos 
> getTargetRepository( 
RepositoryInformation information, EntityMana 
return new CustomRepositoryImpl<T, ID» 
((Class<T>) information.getDomainType(), entityManager); 


j 


QOverride 
protected Class<? 
> getRepositoryBaseClass(RepositoryMetadata metadata) {// 5 
return CustomRepositoryImpl.class; 
} 


代码 解释 


(DE XE X RepositoryFactoryBean, 27K 
JpaRepositoryFactoryBean. 


@) 重 写 createRepositoryFactory 方 法 ， 用 当前 的 
CustomRepositoryFactory 创 建 实例 。 


(3) 创 建 CustomRepositoryFactory， 并 继承 


JpaRepositoryFactory » 





巾 重 写 getTargetRepository 方 法 ， 获 得 当前 自 定义 的 
Repository 实 现 。 





@) 重 写 getRepositoryBaseClass， 获 得 当前 自 定 义 的 
Repository 实 现 的 类 型 。 


(4) 开启 自 定义 支持 使 用 @EnableJpaRepositories 的 
repositoryFactoryBeanClass 来 指定 FactoryBean 即 可 ， 人 代码 如 
下 : 











@EnableJpaRepositories(repositoryFactoryBeanClass= CustomRepo 


8.2.2 Spring Boot 的 支持 


1.JDBC 的 自动 配置 


spring-boot-starter-data-jpa 依 赖 于 spring-boot-starter-jdbc， 
而 Spring Boot 对 JDBC 做 了 一 些 自动 配置 。 源 人 码 放置 在 
org.springframework.boot.autoconfigure.jdbc 下 ， 如 图 8-15 所 示 。 





4 | 出 jdbc 
d metadata 
t2 DatabaseDriver.class 
$a DataSourceAutoConfiguration.class 
DataSourceBuilder.class 
1g DataSourceConfigMetadata.class 
$p DataSourcelnitializedEvent.class 
tm DataSourcelnitializer.class 
{ù DataSourcelnitializerPostProcessor.class 


$a DataSourceProperties.class 


4 DataSourceTransactionManagerAutoConfiguration.class 


1 DriverClassNameProvider.class 

tip EmbeddedDatabaseConnection.class 
EmbeddedDataSourceConfiguration.class 
tap JndiDataSourceAutoConfiguration.class 
tip XADataSourceAutoConfiguration.class 





Kla-15 ”JDBC 源码 位 置 


从 源码 分 析 可 以 看 出 ， 我 们 通过 “spring.datasoure” 为 前 组 
的 属性 自动 配置 dataSource; Spring ”Boot 自动 开启 了 注解 事务 
的 支持 (@EnableTransactionManagement)〉; 还 配置 了 一 个 
jdbcTemplate. 


Spring Boot 还 提供 了 一 个 初始 化 数据 的 功能 : 放置 在 类 路 
径 下 的 schema.sql 文 件 会 自动 用 来 初始 化 表 结 构 ， 放 置 在 类 路 
径 下 的 data.sql 文 件 会 自动 用 来 填充 表 数 据 。 


2. 对 JPA 的 自动 配置 


Spring Boot 对 JPA 的 自动 配置 放置 在 
org.springframework.boot.autoconfigure.orm.jpa 下 ， 如 图 8-16 所 
ZR. 











4 H3 ormjpa 
> hy DataSourcelnitializedPublisher.class 
fis EntityManagerFactoryBuilder.class 
ta HibernateJpaAutoConfiguration.class 
tip JpaBaseConfiguration.class 








ta JpaProperties.class 
图 8-16 ”JPA 的 源码 位 置 


从 HibernateJpaAutoConfiguration 可 以 看 出 ，Spring Boot 默 
认 JPA 的 实现 者 是 Hibernate; HibernateJpaAutoConfiguration 依 
赖 于 DataSourceAutoConfiguration。 


从 JpaProperties 的 源码 可 以 看 出 ， 配 置 JPA 可 以 使 用 
spring.jpa 为 前 级 的 属性 在 application.properties 中 配置 。 


从 JpaBaseConfiguration 的 源码 中 可 以 看 出 ，Spring Boot 为 
我 们 配置 了 transactionManager、jpaVendorAdapter、 
entityManagerFactory 等 Bean。JpaBaseConfiguration 还 有 一 个 
getPackagesToScan 方 法 ， 可 以 自动 扫描 注解 有 @Entity 的 实体 


类 。 


在 Web 项 目 中 我 们 经 常会 遇 到 在 控制 器 或 者 页 面 访问 数据 
的 时 候 出 现 会 话 连接 已 关闭 的 错误 ， 这 时 候 我 们 会 配置 一 个 
Open EntityManager (Session) In View 这 个 过 滤器 。 令 人 惊喜 
的 是 ，Spring Boot 为 我 们 自动 配置 了 
OpenEntityManagerInViewInterceptor 这 个 Bean， 并 注册 到 
Spring MVC 的 拦截 器 中 。 


3. 对 Spring Data JPA 的 自动 配置 


而 Spring ”Boot 对 Spring Data ”JPA 的 自动 配置 放置 在 
org.springframework.boot.autoconfigure.data.jpa 下 ， 如 图 8-17 所 




















4 HH data 
H8 elasticsearch 
4 iB jpa 
EntityManagerFactoryDependsOnPostProcessor.class 
JpaRepositoriesAutoConfiguration.class 








tà JpaRepositoriesAutoConfigureRegistrar.class 





图 8-17 Spring Data JPA 的 自动 配置 


从 JpaRepositoriesAutoConfiguration 和 
JpaRepositoriesAutoConfigureRegistrar 源 码 可 以 看 出 ， 
JpaRepositoriesAutoConfiguration 是 依赖 于 
HibernateJpaAutoConfiguration 配 置 的 ， 且 Spring Booth asta 
了 对 Spring Data JPA 的 文 持 ， 即 我 们 无 须 在 配置 类 显示 声明 
@EnableJpaRepositories. 





4.Spring Boot 下 的 Spring Data JPA 


通过 上 面 的 分 析 可 知 ， 我 们 在 Spring ”Boot 下 使 用 Spring 
Data “JPA， 在 项 目的 Maven 依 赖 里 添加 Spring-boot-stater-data- 
jpa， 然 后 只 需 定 义 DataSource、 实 体 类 和 数据 访问 层 ， 并 在 需 
数据 访问 的 地 方 注 入 数据 访问 层 的 Bean 即 可 ， 无 须 任 何 
额外 配置 。 





8.2.3 ”实战 











在 本 市 的 实战 里 ， 我 们 将 演示 基于 方法 名 的 查询 、 基 于 
@Query 的 查询 、 分 页 及 排序 ， 最 后 我 们 将 结合 Specification 和 和 
自 定义 Repository 实 现 来 完成 一 个 通用 实体 查询 ， 即 对 于 任意 
类 型 的 实体 类 的 传 值 对 象 ， 只 要 对 象 有 值 的 属性 我 们 束 进 行 自 
动 构造 查询 (字符 型 用 like， 其 他 类 型 用 等 于 ) 。 这 里 起 一 个 


抛砖引玉 的 功能 ， 感 兴趣 的 读者 可 以 继续 扩展 ， 如 构造 范围 得 
WW KR BS 


1.238 Oracle XE 


因 大 部 分 Java 程 序 员 在 实际 开发 中 一 般 使 用 的 是 Oracle， 
所 以 此 处 选择 用 Oracle XE 作 为 开发 测试 数据 库 。 


Oracle ”XE 是 Oracle 公 司 提供 的 免费 开 友 测试 用 途 的 数据 
D 自由 使 用 ， 功 能 和 使 用 与 Oracle 完 全 一 致 ， 但 数据 大 小 
限制 为 4G 。 


(1) 非 Docker 安 装 
不 打算 使 用 Docker 安 装 Oracle XE 的 读者 请 至 


http://www.oracle.com/technetwork/database/database- 
technologies/express-edition/downloads/index.html F #¥Oracle XE 
安装 。 


(2) Docker 安 装 


我 们 在 8.13 节 已 经 下 载 了 Oracle XE 的 镜像 ， 现 在 我 们 运行 
启动 一 个 Oracle XE 的 容器 。 











docker run -d -p 9090:8080 -p 1521:1521 wnameless/oracle-xe- 
11g 


将 容器 中 的 Oracle “XE 管 理 界面 的 8080 端 口 映 射 为 本 机 的 
9090 端 口 ， 将 Oracle XE 的 1521 端 口 映 射 为 本 机 的 1521 端 口 。 


本 容器 提供 如 下 的 安 钱 信息 ; 


hostname: localhost 
端口 :1521 

SID: XE 

username: system/sys 
password:oracle 


党 理 界面 访问 : 


url:http://localhost:9090/apex 
workspace:internal 
username:admin 

password:oracle 


(3) 端口 映射 


我 们 在 8.1 节 曾经 提 到 ， 容 器 又 圳 的 端口 只 是 映射 到 
VirtualBox 虚 拟 机 上 ， 而 本 机 要 访问 容器 的 话 需 要 我 们 把 
VirtualBox 的 虚拟 机 的 端口 映射 到 当前 开发 机 堪 上 。 这 确实 有 
点 且 烦 ， 但 是 在 生产 环境 我 们 一 般 都 是 基于 Linux 部 署 Docker 
的 ， 所 以 不 会 存在 这 个 问题 。 


下 面 我 们 演示 将 VirtualBox 虚 拟 机 的 端口 映射 到 当前 开发 
JLAF o 


打开 VirtualBox 软 件 ， 如 图 8-18 所 示 。 
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图 8-18 打开 VirtualBox 软 件 


选中 boot2docker-vm， 单 击 * 设 置 ?按钮 ， 或 者 右 击 ， 在 右 
键 荣 单 中 选中 “设置 >， 打 开 虚 拟 机 设置 页 面 ， 如 图 8-19 所 示 。 


Q boot2docker-vm - 设置 
































B sa 常规 
| 系统 E = 
显示 SRA | HAY | 
B 存储 FW): | boot2docker-wm 

ere WAI): | Linux 

Fa 
P 网 络 Ws: Linux 2.6 / 3.x (64 bit) 
sn 
| 多 USB 设备 
E 共享 文件 夫 

发 现 无 效 设置 eS | [wv | 











图 8-19 ”打开 虚拟 机 设置 页 面 


单 击 “ 网 络 ”"， 页 面 下 方 出 现 了 “路口 转 及 ”按钮 ， 如 图 8-20 
所 示 。 


名 boot2docker-vm - 设置 
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图 8-20 “端口 转发 "按钮 


单 击 “ 端 品 转发 ”按钮 ， 弹 出 “端口 转发 规则 ”界面 ， 将 我 们 
刚才 曝露 到 虚拟 机 的 9090 及 1521 端 口 映 射 为 开发 机 的 9090 及 
1521 端 口 ， 如 图 8-21 所 示 。 





主机 IP 
127.0.0.1 
127.0.0.1 
127.0.0.1 

















图 8-21 将 虚拟 机 器 口 映 射 为 开发 机 器 口 


做 了 如 上 设置 后 ， 我 们 即 可 通过 本 机 9090 及 1521 端 口 正 确 
访问 Oracle XE 容器 里 的 端口 了 。 


(4) 管理 


通过 上 面 的 设置 之 后 ， 我 们 就 可 以 像 操 作 普 通 的 Oracle 数 
据 库 一 样 操作 Oracle ”XE 了 。 我 们 可 以 通过 访问 XE 的 管理 界 
H: http://localhost: 9090/apex 登 录 管 理 数据 库 ; KEENER 
机 器 安装 Oracle Client， 管 理 并 安装 一 个 数据 库 管 理工 具 〈 如 
PL/SQL Developer) 来 管理 数据 库 。 


利用 我 们 的 管理 工具 (如 PL/SQL Developer) 创建 一 个 用 
户 ， 作 为 我 们 程序 使 用 的 数据 库 账号 ， 账 号 密码 此 为 boot。 


3. 新 建 Spring Booth H 





搭建 Spring ”Boot 项目 ， 依 赖 选择 JPA (spring-boot-starter- 
data-jpa) 和 Web (spring-boot-starter-web) 。 


项 目 信 息 : 


groupId: com.wisely 
arctifactId:ch8_2 
package: com.wisely.ch8_2 


因为 我 们 使 用 的 是 Oracle XE 数据 库 ， 所 以 需要 使 用 Oracle 
的 JDBC 驱 动 ， 而 Maven 中 心 库 没有 Oracle JDBC 的 驱动 下 载 ， 
因此 我 们 需要 通过 Maven 命 令 ， 目 己 打 包 Oracle 的 JDBC 驱 动 到 
AS HB FE o 


在 Oracle 官 网 下 载 


ojdbc6.jar Chttp://www.oracle.com/technetwork/database/enterpris: 
edition/jdbc-112010-090769.html) ， 当 然 一 般 我 们 都 有 这 个 jar 
qs 


过 在 控制 合 执行 下 面 命令 ， 将 ojdbc6.jar 安 装 到 本 地 库 : 


mvn install:install-file -DgroupId=com.oracle "- 
Dartifactid-ojdbce" "-Dversion-11.2.0.2.0" j 
Dpackaging=jar" "-Dfile=E:\ojdbc6.jar" 


说 明 : 


-DgroupId=com.oracle: 指定 当前 包 的 groupId 为 
com.oracle. 


-Dartifactid-ojdbc6: 指定 当前 包 的 artifactfactId 为 ojdbc6 。 
-Dversion=11.2.0.2.0: 指定 当前 包 version 为 11.2.0.2.0。 
-Dfile=E: \ojdbc6.jar: 指定 要 打包 的 jar 的 文件 位 置 。 

此 时 ojdbc6 被 打包 到 本 地 库 ， 如 图 8-22 所 示 。 


— Tm 
新 加 卷 (C:) >» FF > wisely » .m2 » repository » com » oracle » ojdbc6 » 11.2.0.2.0 
E ame ee ae a |] 











共享 新 建文 件 夫 
名 称 
L remote.repositories 
国 ojdbc6-11.2.0.2.0 
|_| ojdbc6-11.2.0.2.0.pom 














图 8-22 ”ojdbc6 被 打包 到 本 地 库 


这 时 我 们 只 需 在 Spring ”Boot 项 目 中 的 pom.xml 加 入 下 面 坐 
标 即 可 引入 ojdbc6: 


<dependency> 
<groupId>com.oracle</groupId> 
<artifactId>o0jdbc6</artifactId> 
<version>11.2.0.2.0</version> 
</dependency> 


名 : 


添加 google guava 依 赖 ， 它 包含 大 量 Java 和 常用 的 工具 类 : 


<dependency> 


<groupId>com.google.guava</groupId> 
<artifactId>guava</artifactId> 


<version>18.0</version> 


</dependency> 


新 建 一 个 data.sql 文 件 放置 在 src/main/resources 下， 内 容 为 
问 表 格 增加 一 些 数据 ， 数 据 插入 完成 后 请 删除 或 对 此 文件 改 


insert into person(id, name, age, address) 


z &',32,' iE"); 


insert into person(id, name, age, address) 


Bs 


insert into person(id,name,age,address) 


30, ' EME"); 


insert into person(id, name, age, address) 


729， 南 不 ' ) 


insert into person(id,name, age, address) 


', 28, X"); 


insert into person(id,name, age, address) 


values(hibernate_sequ 
values(hibernate_sequ 


values(hibernate_sequ 


values(hibernate_sequ 


values(hibernate_sequ 


values(hibernate_sequ 


(pele muB 


4. 配 置 基本 属性 
在 application.properties 里 配置 数据 源 和 jpa 的 相关 属性 。 





spring.datasource.driverClassName-oracle.jdbc.OracleDriver 
spring.datasource.url-jdbc 


\ioracle\: thin\:@localhost 


N:11521N:xe 


spring.datasource.username-boot 
spring.datasource.password-boot 


#1 
spring.jpa.hibernate.ddl-auto-update 
#2 

spring. jpa.show-sql=true 

#3 


spring. jackson.serialization.indent_output=true 


代码 解释 





上 面 代 码 第 一 段 是 用 来 配置 数据 源 ， 第 二 段 是 用 来 配置 
jpa， 更 多 配置 内 容 请 查看 附录 A.3 
以 “spring.datasource” 和 “spring.jpa” 为 前 级 的 属性 配置 。 


(Dhibernate 提 供 了 根据 实体 类 自动 维护 数据 库 表 结 构 的 功 
能 ， 可 通过 spring.jpa.hibernate.ddl-auto 来 配置 ， 有 下 列 可 选 
项 : 




















create: 启动 时 删除 上 一 次 生成 的 表 ， 并 根据 实体 类 生成 
表 ， 表 中 数据 会 被 清空 。 

create-drop: 局 动 时 根据 实体 类 生成 表 ，sessionFactory 关 
闭 时 表 会 被 删除 。 

update: 司 动 时 会 根据 实体 类 生成 表 ， 当 实体 类 属性 变动 
的 时 候 ， 表 结构 也 会 更 新 ， 在 初期 开发 阶段 使 用 此 选项 。 
validate: 局 动 时 验证 实体 类 和 数据 表 是 否 一 致 ， 在 我 们 数 
据 结构 稳定 时 采用 此 选项 。 

none: 不 采取 任何 指 施 。 


@spring.jpa.show-sql 用 来 设置 hibernate 操 作 的 时 候 在 控制 
台 显 示 其 真实 的 sql 语 人 句 。 


全 让 控制 器 输出 的 json 字 符 串 格式 更 美观 。 
5. SCHR SE RSE 
Hibernate 文 持 自 动 将 实体 类 映射 为 数据 表格 : 

















package com.wisely.domain; 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity //1 
@NamedQuery(name = "Person.withNameAndAddressNamedQuery", 


query = "select p From Person p where p.name=? 
1 and address=?2") 
public class Person { 

@Id //2 

@GeneratedValue //3 

private Long id; 


private String name; 
private Integer age; 
private String address; 


public Person() { 
super(); 


public Person(Long id, String name, Integer age, String a 
super () 
this.id = id; 
this.name = name; 
this.age = age; 
this.address = address; 


} 

// setter, getter 
} 
代码 解释 


OO@Entity 注 解 指明 这 是 一 个 和 数据 库 表 映射 的 实体 类 。 
CI@Id 注 解 指明 这 个 属性 映射 为 数据 库 的 主键 。 


GO@OGeneratedValue 注 解 默认 使 用 主键 生成 方式 为 目 增 ， 
hibernate 会 为 我 们 上 自动 生成 一 个 名 为 HIBERNATE_SEQUENCE 
的 序列 。 


在 此 例 中 使 用 的 注解 也 许 和 你 平时 经 常 使 用 的 注解 实体 类 
不 大 一 样 ， 比 如 没有 使 用 @Table( 实 体 类 映射 表 名 ) 、 
@Column (属性 映射 字段 名 ) 注解 。 这 是 因为 我 们 是 采用 下 








问 工 程 通 过 实体 类 生成 表 结构 ， 而 不 是 通过 逆 癌 工程 从 表 结 构 
生成 数据 库 。 


在 这 里 你 可 能 注意 到 ， 我 们 没有 通过 @Column 注 解 来 注解 
普通 属性 ，@Column 是 用 来 映射 属性 名 和 字段 名 ， 不 注解 的 
时 候 hibernate 会 上 自动 根据 属性 名 生成 数据 表 的 字段 名 。 如 属性 
名 name 映 射 成 字段 NAME;， 多 字母 属性 如 testName 会 自动 映射 
为 TEST_NAME。 表 名 的 映射 规则 也 如 此 。 


6. 定 义 数据 访问 接口 

















package com.wisely.dao; 
import java.util.List; 


import org.springframework.data.jpa.repository.JpaRepository; 
import org.springframework.data.jpa.repository.Query; 


import com.wisely.domain.Person; 


public interface PersonRepository extends JpaRepository<Perso 
//1 
List<Person> findByAddress(String name); 
//2 
Person findByNameAndAddress(String name,String address); 
/f3 
QQuery("select p from Person p where p.name- :name and p. 
Person withNameAndAddressQuery(QParam("name")String name, 

QParam("address" 


//4 

List<Person> withNameAndAddressNamedQuery(String name, Str 
J 
代码 解释 





QD 使 用 方法 名 查询 ， 接 受 一 个 name 参 数 ， 返 回 值 为 列表 。 





@) 使 用 方法 名 查询 ， 接 受 name 和 address， 返 回 值 为 单个 对 
象 。 





(3) 使 用 @Query 人 查询 ， 参 数 按照 名 称 绑 定 。 


(4) 使 用 @NamedQuery 人 查询 ， 请 注意 我 们 在 实体 类 中 做 的 
@NamedQuery 的 定义 。 


Tie 


在 本 例 中 没有 复杂 的 业务 逻辑 ， 我 们 将 PersonRepository 注 
入 到 控制 器 中 ， 以 简化 演示 。 





package com.wisely.web; 
import java.util.List; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.data.domain.Page; 

import org.springframework.data.domain.PageRequest; 

import org.springframework.data.domain.Sort; 

import org.springframework.data.domain.Sort.Direction; 

import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RestController 


import com.wisely.dao.PersonRepository; 
import com.wisely.domain.Person; 


@RestController 
public class DataController { 
//1 Spring Data JPA 已 自动 为 你 注册 bean， 所 以 可 自动 注入 
@Autowired 
PersonRepository personRepository; 
/** 


* 


* _ Save 支持 批量 保存 : <S extends T» Iterable 


<S> save(Iterable 


<S> entities); 
* 


* 删除 : 

* 支 持 使 用 id 删除 对 象 、 批 量 删除 以 及 删除 全 部 ; 
* void delete(ID id); 

* void delete(T entity); 

* void delete(Iterable 





<? extends T> entities); 
* void deleteAll(); 
* 
*/ 
QRequestMapping("/save") 
public Person save(String name,String address,Integer age 


{ 
Person p = personRepository.save(new Person(null, nam 
return p; 
} 
JER 
* 测试 findByAddress 
"y 


@RequestMapping("/qi") 
public List<Person> qi(String address) { 


List<Person> people = personRepository.findByAddress( 


return people; 


j 


/** 
* 测试 findByNameAndAddress 
TP 
QRequestMapping("/q2") 
public Person q2(String name,String address)( 


Person people = personRepository.findByNameAndAddress 
return people; 


j 


/** 

* 测试 withNameAndAddressQuery 
@RequestMapping("/q3") 
public Person q3(String name, String address) { 


Person p = personRepository.withNameAndAddressQuery(n 
return p; 


j 


/** 
* 测试 withNameAndAddressNamedQuery 
*/ 
@RequestMapping("/q4") 
public Person q4(String name,String address){ 


Person p = personRepository.withNameAndAddressNamedQu 
return p; 


j 

* 测试 排序 

*/ 
@RequestMapping("/sort") 
public List<Person> sort(){ 


List<Person> people = personRepository.findAll(new So 
return people; 


j 


/** 

* 测试 分 页 

i d 
QRequestMapping("/page") 
public Page<Person> page(){ 


Page<Person> pagePeople = personRepository.findAll(ne 


return pagePeople; 


下 面 分 别 访问 地 址 测试 运行 效果 。 


访问 http://localhost: 8080/save? name=dd&address= 上 海 
&age=25， 如 图 8-23 所 示 。 


@ localhost:8080/save?n: x¥ Y 


C localhost:8080/save?name=dd&address= Fig&age- 25 








图 8-23 访问 http://localhost: 8080/save? name-dd&address- |-7& 
&age=25 


W http://localhost: 8080/q1? address= 合 肥 ， 如 图 8-24 所 





r 


@ localhost:8080/q1?addr x \ 





€ CB localhost:8080/q1?address- &8E WW = 








图 8-24 访问 : http://localhost: 8080/q1? address= 合 肥 


访问 http://localhost: 8080/q2? address= 合 肥 &name= 汪 云 
飞 ， 如 图 8-25 所 示 。 





@ localhost:8080/q2?add 





Sy) M 
x Y CN 
€ Q | D localhost:8080/q2?address- &i8&B&name-itz! =| 
"id" : 25, 
"name" : "EZ M, 
"age" : 32, 


"address" : "&W" 








图 8-25 ”访问 http://localhost: 8080/32? address= 合 肥 &name= 汪 云 飞 


访问 http://localhost: 8080/q3? address= 合 肥 &name= 汪 云 
飞 ， 如 图 8-26 所 示 。 
















i — F^ ain 
@ localhost:8080/q3?add x \ O42, =. 
€ Œ | D localhost:8080/q3?address- &iB&name-itz 








d 


图 8-26 访问 http://localhost: 8080/33? address= 合 肥 &name= 汗 云 飞 


访问 http://localhost: 8080/q4? address= 合 肥 &name= 汪 云 
飞 ， 如 图 8-27 所 示 。 





' Æ localhost:8080/q4?addr x Y Y 
€ Q | D localhost:8080/q4?address- &iBB&name-itz = 
{ 

"id" : 25, 

“name” : “SER K 

age" : 32, 
"address" : “GIB 
i 











图 8-27 访问 http://localhost: 8080/q4? address= 合 肥 &name= 汪 云 飞 


访问 http://localhost: 8080/sort， 如 图 8-28 所 示 。 








@ localhost:8080/sort x Y d 


€ C | D localhost:8080/sort 2 Ə 
[t 

“id” : 32 

"name" : “dd", 


图 8-28 ”访问 http://localhost: 8080/sort 


访问 http://localhost: 8080/page， 如 图 8-29 所 示 。 





-= | 总 


@ localhost:8080/page x \ 


ÈE 


€ C | D localhost:8080/page 





1], 

"totalPages" : 4, 
"totalElements" : T, 
"last" : false, 

*size" : 2, 

"number" : 1, 

"sort" : mull, 

"first" : false, 
"numberOfElements" : 2 











图 8-29 ”访问 http://localhost: 8080/page 
7.É «€ X. Repository Sli 


上 面 的 实战 演示 已 经 包含 了 Spring Boot 和 Spring Data JPA 
组 合 的 绝 大 多 数 功 能 。 下 面 我 们 将 结合 Specification 和 上 自 定 义 
Repository 实 现 来 定制 一 个 自动 模糊 查询 。 即 对 于 任意 的 实体 
对 象 进行 查询 ， 对 象 里 有 几 个 值 我 们 就 得 几 个 值 ， 当 值 为 字符 
型 时 我 们 就 自动 lke 查 询 ， 其 余 的 类 型 使 用 上 自动 等 于 查询 ， 没 
有 值 我 们 就 查询 全 部 。 


(1) 定义 Specification: 














package com.wisely.specs; 
import static com.google.common.collect.Iterables.toArray; 
import java.lang.reflect.Field; 


import java.util.ArrayList; 
import java.util.List; 


import javax.persistence.EntityManager ; 

import javax.persistence.criteria.CriteriaBuilder; 
import javax.persistence.criteria.CriteriaQuery; 
import javax.persistence.criteria.Predicate; 

import javax.persistence.criteria.Root; 

import javax.persistence.metamodel.Attribute; 

import javax.persistence.metamodel.EntityType; 

import javax.persistence.metamodel.SingularAttribute; 


import org.springframework.data.jpa.domain.Specification; 
import org.springframework.util.ReflectionUtils; 
import org.springframework.util.StringUtils; 


public class CustomerSpecs { 
public static <T> Specification<T> byAuto(final EntityMan 
final Class<T> type = (Class<T>) example.getClass();/ 
return new Specification<T>() { 


@Override 
public Predicate toPredicate(Root<T> root, Criter 
> query, CriteriaBuilder cb) { 
List<Predicate> predicates = new ArrayList<> 
(); 7/73 


EntityType<T> entity = entityManager.getMetam 


for (Attribute<T, ? 
> attr : entity.getDeclaredAttributes()) {//5 

Object attrValue = getValue(example, attr 

if (attrValue != null) { 
if (attr.getJavaType() == String.clas 
if (!StringUtils.isEmpty(attrValu 
predicates.add(cb.like(root.g 
pattern((String) attr 


} 
} else { 
predicates.add(cb.equal(root.get(attribute(entity, attr.g 
attrValue)); //10 
} 


} 


return predicates.isEmpty() ? cb.conjunction( 


/** 


* 12 
*/ 
private <T> Object getValue(T example, Attribute< 
> attr) { 
return ReflectionUtils.getField((Field) attr. 
} 
* 13 
*/ 
private <E, T> SingularAttribute<T, E> attribute( 
Class<E> fieldClass) { 
return entity.getDeclaredSingularAttribute( fi 
} 
}; 
} 
/** 
* 14 
*/ 


static private String pattern(String str) { 
return "%" + str + "%"; 
} 


代码 解释 

QD 定义 一 个 返回 值 为 Specification 的 方法 byAuto， 这 里 使 用 
的 是 泛 型 T， 所 以 这 个 Specification 是 可 以 用 于 任意 的 实体 类 
的 。 它 接受 的 参数 是 entityManager 和 当前 的 包含 值 作 为 查询 条 
件 的 实体 类 对 象 。 

@ 获 得 当前 实体 类 对 象 类 的 类 型 。 


(3) 新 建 Predicate 列 表 存 储 构 造 的 查询 条 件 。 

















(4) 获 得 实体 类 的 EntityType， 我 们 可 以 从 EntityType 获 得 实 
体 类 的 属性 。 


(对 实体 类 的 所 有 属性 做 循环 。 
9 获得 实体 类 对 象 茶 一 个 属性 的 值 。 








GO 当前 属性 值 为 字符 类 型 的 时 候 。 
OE 2A Bl E SEIS ZAR ERI PE F e 
@ 构 造 当 前 属性 like (前 后 %) 属性 值 查询 条 件 ， 并 添加 到 














条 件 列表 中 。 
其 余 情况 下 ， 构 造 属 性 和 属性 值 equal 碍 询 条 件 ， 并 添加 
到 条 件 列表 中 。 


第 将 条 件 列 表 转 换 成 Predicate。 


2 通过 





反射 获得 实体 类 对 象 对 应 属性 的 属性 值 。 





(3 获得 实体 类 的 当前 属性 的 SingularAttribute， 
SingularAttribute 包 含 的 是 实体 类 的 某 个 单独 属性 。 


构造 like 的 查询 模式 ， 即 前 后 加 %。 
(2) 定义 接口 : 





package com.wisely.support; 


import 


import 
import 
import 
import 
import 


java.io.Serializable; 


org.springframework.data.domain.Page; 
org.springframework.data.domain.Pageable; 
org.springframework.data.jpa.repository.JpaRepository; 
org.springframework.data.jpa.repository.JpaSpecificati 
org.springframework.data.repository.NoRepositoryBean; 


@NoRepositoryBean 
public interface CustomRepository<T, ID extends Serializable> 


{ 


Page<T> findByAuto(T example,Pageable pageable); 


代码 解释 


此 例 中 的 接口 继承 了 JpaRepository， 让 我 们 具备 了 
JpaRepository 所 提供 的 方法 ; 继承 了 JpaSpecificationExecutor， 
让 我 们 具备 使 用 Specification 的 能 力 。 


(3) 定义 实现 : 


package com.wisely.support; 

import java.io.Serializable; 

import javax.persistence.EntityManager ; 

import org.springframework.data.domain.Page; 

import org.springframework.data.domain.Pageable; 

import org.springframework.data.jpa.repository.support.Simple 


import static com.wisely.specs.CustomerSpecs.*; 


public class CustomRepositoryImpl «T, ID extends Serializable 
extends SimpleJpaRepository<T, ID» imple 


private final EntityManager entityManager; 

public CustomRepositoryImpl(Class«T» domainClass, EntityM 
super(domainClass, entityManager); 
this.entityManager - entityManager; 


j 


@Override 


public Page<T> findByAuto(T example, Pageable pageable) { 
return findAll(byAuto(entityManager, example), pageabl 


j 


代码 解释 


此 类 继承 JpaRepository 的 实现 类 SimpleJpaRepository， 让 我 
们 可 以 使 用 SimpleJpaRepository 的 方法 ， 此 类 当然 还 要 实现 我 
们 自 定 义 的 接口 CustomRepository。 


findByAuto 方 法 使 用 byAuto Specification 构 造 的 条 件 查询 ， 
并 提供 分 页 功能 。 


(4) 定义 repositoryFactoryBean: 


package com.wisely.support; 


import 
import 


import 
import 
import 
import 
import 
import 
import 


public 


java.io.Serializable; 


javax.persistence.EntityManager; 


org. 
org. 
org. 
org. 
org. 


org 


org. 


springframework. 
springframework. 
springframework. 
springframework. 
springframework. 
.Springframework. 
springframework. 


data. 
data. 
data. 
data. 
data. 
data. 
data. 


jpa. 
jpa. 
jpa. 
jpa. 


repository.JpaRepository; 
repository.support.JpaRep 
repository.support.JpaRep 
repository.support.Simple 


repository.core.RepositoryInf 
repository.core.RepositoryMet 
repository.core.support.Repos 


class CustomRepositoryFactoryBean<T extends JpaReposit 
extends JpaRepositoryFactoryBean<T, S, ID» ( 


QOverride 
protected RepositoryFactorySupport createRepositoryFactor 
return new CustomRepositoryFactory(entityManager); 


j 


private static class CustomRepositoryFactory extends JpaR 


public CustomRepositoryFactory(EntityManager entityMa 
super(entityManager); 


QOverride 
@SuppressWarnings({"unchecked"} ) 
protected <T, ID extends Serializable> SimpleJpaRepos 
> getTargetRepository( 
RepositoryInformation information, EntityMana 
return new CustomRepositoryImpl<T, ID» 
((Class<T>) information.getDomainType(), entityManager); 


j 


QOverride 
protected Class<? 
> getRepositoryBaseClass(RepositoryMetadata metadata) { 
return CustomRepositoryImpl.class; 
} 


代码 解释 


在 8.2.1 中 我 们 对 定义 RepositoryFactoryBean 做 了 讲解 ， 这 
里 的 代码 大 可 以 作为 模板 代码 使 用 ， 只 需 修 改 和 定义 实现 类 相 
关 的 代码 即 可 。 


(5) 使 用 : 








package com.wisely.dao; 
import java.util.List; 


import org.springframework.data.jpa.repository.Query; 
import org.springframework.data.repository.query.Param; 


import com.wisely.domain.Person; 
import com.wisely.support.CustomRepository; 


-> 


public interface PersonRepository extends CustomRepository<Pe 


List<Person> findByAddress(String address); 

Person findByNameAndAddress(String name,String address); 
@Query("select p from Person p where p.name= :name and p. 
Person withNameAndAddressQuery(QParam("name")String name, 
Person withNameAndAddressNamedQuery(String name,String ad 


代码 解释 


只 需 让 实体 类 Repository 继 承 我 们 目 定 义 的 Repository 接 
即 可 使 用 我 们 在 自 定 义 Respository 中 实现 的 功能 。 


package com.wisely.web; 


import 


import 
import 
import 
import 
import 
import 
import 


import 
import 


java.util.List; 


org. 


org 


org. 
org. 
org. 


org 


com 
com 


springframework. 
.Springframework. 
springframework. 
springframework. 
springframework. 
.springframework 
org. 


springframework 


QRestController 
public class DataController { 


beans.factory.annotation.Autowired 
data.domain.Page; 
data.domain.PageRequest; 
data.domain.Sort; 
data.domain.Sort.Direction; 


.web.bind.annotation.RequestMapping 
.web.bind.annotation.RestController 


.wisely.dao.PersonRepository; 
.wisely.domain.Person; 


QRequestMapping("/auto") 
public Page<Person> auto(Person person)( 


Page<Person> pagePeople = personRepository.findByAuto 


return pagePeople; 


代码 解释 


控制 器 中 接受 一 个 Person 对 象 ， 当 Person 的 name 有 值 时 ， 
会 目 动 对 name 进 行 like 查 询 ; 当 age 有 值 时 ， 会 进行 等 于 查询 ; 
当 Person 中 有 多 个 值 不 为 空 的 时 候 ， 会 目 动 构造 多 个 碍 询 条 
ft. 当 Person 所 有 值 为 空 的 时 候 ， 默 认 查 询 出 所 有 记录 。 


此 处 需 














性 别 指 出 的 是 ， 在 实体 类 中 定义 的 数据 类 型 要 用 


包装 类 型 (Long, Integer) ， 而 不 能 使 用 原始 数据 类 型 
(long、int) 。 因 为 在 Spring MVC 中 ， 使 用 原始 数据 类 型 会 自 
动 初 始 化 为 0， 而 不 是 空 ， 导 致 我 们 构造 条 件 失败 。 


(60 配置 : 








package com.wisely; 


import 
import 
import 
import 


import 
import 


org. 
org. 
org. 
org. 


com 
com 


springframework.beans.factory.annotation.Autowired 
springframework.boot.SpringApplication; 

springframework.boot.autoconfigure.SpringBootAppli 
springframework.data.jpa.repository.config.EnableJ 


.wisely.dao.PersonRepository; 
.wisely.support.CustomRepositoryFactoryBean; 


@SpringBootApplication 
@EnableJpaRepositories(repositoryFactoryBeanClass = CustomRep 
public class Ch82Application { 

@Autowired 

PersonRepository personRepository; 


public static void main(String[] args) { 
SpringApplication.run(Ch82Application.class, args); 


代码 解释 





在 配置 类 上 配置 @EnableJpaRepositories， 并 指定 
repositoryFactoryBeanClass， 让 我 们 目 定 义 的 Repository 实 现 起 


A 


N 
XX o 











如 果 我 们 不 需要 自 定义 Repository 实 现 ， 则 在 Spring Data 
JPA 里 无 须 添加 @EnableJpaRepositories 注 解 ， 因 为 
@SpringBootApplication 包 含 的 @EnableAutoConfiguration 注 解 
己 经 开启 了 对 Spring Data JPA 的 支持 。 


部 运行 


访问 http://localhost: 8080auto， 无 构造 查询 条 件 ， 查 询 全 
部 ， 如 图 8-30 所 示 。 








" 
"totalElements" : 
"size" : 10, 

"number" : 0, 
"mumberOfElements" : 7, 
"sort" : mill, 

"first" : true 





图 8-30 “无 构造 查询 条 件 


访问 http://localhost: 8080/auto? address= 肥 ， 构 造 address 
的 like 碍 询 ， 如 图 8-31 所 示 。 


j @ localhost:8080/auto?ad x WE 
€ > CQ  [3localhost:8080/auto?address- RB 





{ 
"content" : [ { 
“id” : 30, 


ag 
"address" : " 
Ba; 
"last" : true, 
"totalPages" : 1, 
"totalElements" : 2, 
"pice! 3°10, 
“rumber” : 0, 
"mumberOfElements" : 2, 
"sort" : mill, 
"first" : true 


} 





图 8-31 构造 address 的 like 查 询 


访问 http://localhost: 8080/auto? address= 肥 &name= 云 
&age=32， 构 造 address 的 like 查 询 、name 的 like 查 询 以 及 age 的 
eqdual 和 查询， 如 图 8-32 所 示 。 


@ localhost:8080/auto?ad x V — Y 
€ > QC | Dlocalhost8080/auto?address-RE&name-z;&age- w €) = 





"content" : [ { 
*id" : 25, 
"name" : “SEZ 
"age" : 32, 
"address" : " 

1 1; 

"last" : true, 

"totalPages" : 1, 

"totalElements" : 1, 

"size" : 10, 

"number" : 0, 


"munberOfElements" : 1, 
"sort" : null, 
"first" : true 





图 8-32 ”构造 address 的 like 查 询 、name 的 like 查 询 以 及 age 的 equal 查 询 


0.3 Spring Data REST 


8.3.1 点睛 Spring Data REST 


(1) 什么 是 Spring Data REST 


Spring Data JPA 是 基于 Spring Data 的 repository 之 上 ， 可 以 
将 repository 上 自动 输出 为 REST 资 源 。 目 前 Spring Data REST 支 持 
将 Spring Data JPA、Spring Data MongoDB、Spring Data 
Neo4j、Spring Data GemFire 以 及 Spring Data Cassandra} 
repository 自 动 转 换 成 REST 服 务 。 


(2) Spring MVC 中 配置 使 用 Spring Data REST 





Spring Data REST 的 配置 是 定义 在 
RepositoryRestMvcConfiguration Corg.springframework.data.rest. 
配置 类 中 已 经 配置 好 了 ， 我 们 可 以 通过 继承 此 类 或 者 直接 在 目 
己 的 配置 类 上 @Import 此 配置 类 。 


1) 继承 方式 演示 : 








@Configuration 
public class MyRepositoryRestMvcConfiguration extends Reposit 
@Override 
public RepositoryRestConfiguration config() { 
return super.config(); 
} 


// 其 他 可 重 写 以 config 开 头 的 方法 





20 导入 方式 演示 : 


@Configuration 
QImport(RepositoryRestMvcConfiguration.class) 
public class AppConfig { 


} 


因 在 Spring MVC 中 使 用 Spring Data REST 和 在 Spring Boot 
中 使 用 方式 是 一 样 的 ， 因 此 我 们 将 在 实战 环节 讲解 Spring Data 
REST。 





8.3.2 Spring Boot 的 支持 


Spring Boot 对 Spring Data REST 的 自动 配置 放置 在 Rest 中 ， 
如 图 8-33 所 示 。 


4 出 rest 
tù RepositoryRestMvcAutoConfiguration.class 











tù SpringBootRepositoryRestMvcConfiguration.class 





图 8-33  Restk 


通过 SpringBootRepositoryRestMvcConfiguration 类 的 源码 我 
们 可 以 得 出 ，Spring Boot 已 经 为 我 们 目 动 配置 了 
RepositoryRestConfiguration， 上 所 以 在 Spring Boot" {E Spring 
Data REST 只 需 引 入 spring-boot-starter-data-rest 的 依赖 ， 无 须 任 
何 配置 即 可 使 用 。 


Spring Boot 通 过 在 application.properties 中 配置 
以 “spring.data.rest” 为 前 级 的 属性 来 配置 
RepositoryRestConfiguration， 如 图 8-34 所 示 。 





spring.data.rest.base-path : java.net.URI 
spring.data.rest.default-page-size : int 
spring.data.rest.limit-param-name : String 
spring.data.rest.max-page-size : int 


spring.data.rest.page-param-name : String 
spring.data.rest.return-body-on-create : boolean 


spring.data.rest.return-body-on-update : boolean 





图 8-34 fic RepositoryRestConfiguration 
8.3.3 ”实战 


(1) 新 建 Spring Boot 项 目 。 


新 建 Spring Boot 项 目 ， 依 赖 为 JPA (spring-boot-starter-data- 
jpa) 和 Rest Repositories (spring-boot-starter-data-rest) . 


项 H 信 A : 


groupId: com.wisely 
arctifactId:ch8 3 
package: com.wisely.ch8 3 


添加 Oracle JDBCKS), 4-Eapplication.properties fc E 4H2X 
属性 ， 与 上 例 保持 一 致 。 


(2) 实体 类 : 


package com.wisely.ch8_3.domain; 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


@Entity 

public class Person { 
@Id 
@GeneratedValue 
private Long id; 
private String name; 
private Integer age; 
private String address; 


public Person() { 
super(); 
public Person(Long id, String name, Integer age, String a 
super(); 
this.id = id; 
this.name = name; 
this.age = age; 
this.address = address; 


} 
//@'Sgetter, setter 


(3) 实体 类 的 Repository: 


package com.wisely.ch8_3.dao; 

import org.springframework.data.jpa.repository.JpaRepository; 
import com.wisely.ch8_3.domain.Person; 

public interface PersonRepository extends JpaRepository<Perso 


Person findByNameStartsWith(String name); 


(4) 安装 Chrome 插 件 Postman REST Client. 


Postman 是 一 个 文 持 REST 的 客户 端 ， 我 们 可 以 用 它 来 测试 
我 们 的 REST 资 源 。 


本 市 将 会 Postman 插 件 放 在 源码 中 ， 下 面 讲解 Postman 在 
Chrome 下 的 安装 方式 ， 这 与 在 Chrome 浏 览 器 下 安装 其 他 插件 
是 一 致 的 。Postman 插 件 放 置 于 本 节 示 例 的 src/main/resources 日 
录 下 。 


本 书 使 用 的 Chrome 版 本 是 43.0，Postman 版 本 是 3.0.4。 新 
版 本 的 Chrome 限 制 非 Chrome 应 用 商店 的 插件 安装 。 下 面 来 安 
装 Postman 插 件 。 


用 解压 缩 软件 打开 postman.crx， 并 解压 到 任意 目录 ， 如 
图 8-35 所 示 。 





» HP » wisely » FE > postman » 


test_runner 
test runner tester 
tester sandbox 


background 

Y)background template 

E: background template test 
{embedded ga 


6 embedded ga host 
embedded ga host 
"Xiembedded ga host 
$)ga details 
W icon 
WW icon, 16 
W icon 32 
& icon 48 
& icon 64 
W icon 128 
index 
manifest json 


requester 





图 8-35 ”打开 postman.crx 
将 _metadata 文 件 夹 名 称 修改 为 metadata。 


打开 Chrome 软 件 ， 设 置 一 扩展 程序 ， 打 开 * 开 发 者 模式 ”， 
并 从 “加 载 正 在 开发 的 扩展 程序 .加载 我 们 刚才 解压 的 目录 ， 
如 图 8-36 所 示 。 





E e hrome://extensions 





扩展 程序 y.» Terex 
NOIEE TES 251 RET. 79er mu. DEAR mw 





| 丢 径 扩展 程序 目录 。 





B 我 的 视频 
k 我 的 图 片 
月 我 的 文档 
b BEF 
4h FX 
4 |. postman 
J locales 





ZAM): postman 


| (tie OD EL: 














图 8-36 ”加 载 Postman 
安装 完成 后 的 效果 如 图 8-37 所 示 。 





Chrome 扩展 程序 w 开发 土楼 式 
加 载 正 在 开发 的 扩展 程序 .… 打包 扩展 程序 立即 更 新 扩 是 程序 
PREF 








e Postman — 304 ¥ 已 启用 8 
4 FES ”启动 ”重新 加 载 (Ctri*R) 


ID : jnodapbokmgldoemmijgifcineapgojp 
加 载 来 源 : ~\Downloads\postman 


图 8-37 ”加 载 完 成 


@) 在 Chrome 地 址 栏 输入 “chrome: Wapps”， 可 看 到 
Postman， 如 图 8-38 上 所 示 。 











€ > C [Dchrome//apps | 


pps 








尚未 登录 Chrome 
(无 法 同步 - 登录 ) 


— - 





Chrome 网 上 应 用 店 a 


8-38 ”通过 Chrome 查 看 Postman 


或 者 通过 Chrome 提 供 的 快捷 方式 打开 ， 如 图 8-39 所 示 。 


e a 


Chrome Chrome... | 





图 8-39 通过 Chrome 提 供 的 快捷 方式 打开 Postman 
Postman 的 界面 如 图 8-40 所 示 。 














图 8-40 “Postman 界 面 


5.REST 服 务 测 试 
在 这 里 我 们 使 用 Postman 测 试 REST 资 源 服务 。 
(1) jQuery 


在 实际 开发 中 ， 在 jQuery 我 们 使 用 $.ajax 方 法 的 type 属 性 来 
修改 提交 方法 : 


$.ajax({ 
type: "GET", 
dataType: "json", 
url: "http://localhost:8080/persons ", 
success: function(data) { 
alert(data); 


} 
3): 


(2) AngularJS 
在 实际 开发 中 ， 可 以 使 用 $http 对 象 来 操作 : 


$http.get(url) 
$http.post(url,data) 
$http.put(url, data) 


$http.delete(url) 


(3) 列表 


在 实际 开发 中 ， 在 Postman 中 使 用 GET 访 问 http:Wlocalhost: 
8080/persons， 获 得 列表 数据 ， 如 图 8-41 所 示 。 


miie SS ~ 












图 8-41 ”获得 列表 数据 
(4) 获取 单一 对 象 


在 Postman 中 使 用 GET 访 问 http://localhost: 8080/1， 获 得 id 
为 1 的 对 象 ， 如 图 8-42 所 示 。 





图 8-42 ”获得 id 为 1 的 对 象 
(5) 查询 


在 上 面 的 自 定义 实体 类 Repository 中 定义 了 
findByNameStartsWith 方 法 ， 奇 想 此 方法 也 骏 露 为 REST 资 源 ， 
需 做 如 下 修改 : 





public interface PersonRepository extends JpaRepository<Perso 


@RestResource(path = "nameStartsWith", rel = "nameStartsW 
Person findByNameStartsWith(QParam("name")String name); 


此 时 在 Postman 中 使 用 GET 访 问 http://localhost: 
8080/persons/search/nameStartsWith? name= 汪 ， 可 实现 查询 操 
作 ， 如 图 8-43 所 示 。 


(6) 分 页 





在 Postman 中 使 用 GET 访 问 http://localhost: 8080/persons/? 
page=1&size=2，page=1 即 第 二 页 ，size=2 即 每 页 数量 为 2， 如 
图 8-44 所 示 。 











图 8-43 ”回应 现 查 询 操 作 














图 8-44 分布 


从 返回 结果 可 以 看 出 ， 我 们 不 仅 能 获得 当前 分 页 的 对 象 ， 





而 且 还 给 出 了 我 们 上 一 页 、 下 一 页 、 第 一 页 、 最 后 一 页 的 
REST 资 源 路 径 。 


(7) 排序 


在 Postman 中 使 用 GET 访 问 localhost: 8080/persons/? 
sort=age，desc， 即 按照 age 属 性 倒序 ， 如 图 8-45 所 示 。 





图 8-45 “排序 


(8) 保存 


问 http://localhost: 8080/persons 发 起 POST 请 求 ， 将 我 们 要 
保存 的 数据 放置 在 请 求 体 中 ， 数 据 类 型 设置 为 JSON，JSON 内 
容 如 图 8-46 所 示 。 


("name":"cc", "address":" 成 都 ", "age":24} 








图 8-46 ”保存 


通过 输出 可 以 看 出 ， 保 存 成 功 后 ， 我 们 的 新 数据 的 id 为 
21. 


(9) 更 新 
现在 我 们 更 新 新 增 的 id 为 21 的 数据 ， 用 PUT 方式 访问 


http://localhost: 8080/persons/21， 并 修改 提交 的 数据 ， 如 图 8- 
47 所 示 。 


("name":"cc2", "address": "Xd", "age":23} 























O ĉĉ ĉl me ë au. i2. c mtu 
ied G 2) =o Dem oe 
EM - 
Body «u»(9 
ELT 
图 8-47 ”更 新 


从 输出 我 们 可 以 看 出 ， 数 据 更 新 已 成 功 。 
(10) 删除 
在 这 一 步 我 们 删除 刚才 新 增 的 id 为 21 的 数据 ， 使 用 


DELETE 方 式 访 问 http:/localhost: 8080/persons/21， 如 图 8-48 
所 示 。 















































图 8-48 ”删除 


此 时 再 用 GET 方 式 访问 http://localhost: 8080/persons/21, 
如 图 8-49 所 示 。 





Authorization 
























































图 8-49 获取 失败 
返回 结果 为 404 Not Found， 说 明 所 访问 的 REST 资 源 不 存 


在 。 


6. 定 制 
C1) 定制 根 路 径 


在 上 面 的 实战 例子 中 ， 我 们 访问 的 REST 资 源 的 路 径 是 在 
根 目录 下 的 ， 即 http://localhost: 8080/persons， 如 果 我 们 需要 
定制 根 路 径 的 话 ， 只 需 在 Spring Boot 的 application.properties 下 
增加 如 下 定义 即 可 : 


spring.data.rest.base-path- /api 


此 时 REST 资 源 的 路 径 变 成 了 http://localhost: 
8080/api/persons - 


(20 ERE RERE 


上 例 实战 中 ， 我 们 的 节点 路 径 为 http:/localhost: 
8080/persons， 这 是 Spring Data REST 的 默认 规则 ， 就 是 在 实体 
类 之 后 加 *s” 来 形成 路 径 。 我 们 知道 person 的 复数 是 people 而 不 
是 persons， 在 类 似 的 情况 下 要 对 映射 的 名 称 进行 修改 的 话 ， 我 
们 需要 在 实体 类 Repository 上 使 用 @RepositoryRestResource 注 
解 的 path 属 性 进行 修改 ， 代 人 码 如 下 : 





@RepositoryRestResource(path = "people" ) 
public interface PersonRepository extends JpaRepository<Perso 


@RestResource(path = "nameStartswith", rel = "nameStartsW 
Person findByNameStartsWith(QParam("name")String name); 


此 时 我 们 访问 REST 服 务 的 地 址 变 为 :http://localhost: 


8080/api/people. 


8.4 声名 式 事 务 
8.4.1 Spring 的 事务 机 制 


所 有 的 数据 访问 技术 都 有 事务 处 理 机 制 ， 这 些 技术 提供 了 
API 用 来 开户 事务 、 提 区 事务 来 完成 数据 操作 ， 或 者 在 发 生 错 
误 的 时 候 回 滚 数 据 。 


而 Spring 的 事务 机 制 是 用 统一 的 机 制 来 处 理 不 同 数据 访问 
技术 的 事务 处 理 。Spring 的 事务 机 制 提供 了 一 个 
PlatformTransactionManager 接 口 ， 不 同 的 数据 访问 技术 的 事务 
使 用 不 同 的 接口 实现 ， 如 表 8-3 所 示 。 


表 8-3 ”数据 访问 技术 及 实现 


数据 访问 技术 实 现 















































在 程序 中 定义 事务 管理 器 的 代码 如 下 : 


@Bean 
public PlatformTransactionManager transactionManager() { 


JpaTransactionManager transactionManager = new JpaTransac 
transactionManager .setDataSource(dataSource()); 
return transactionManager ; 





8.4.2 ”声名 式 事务 








Spring 文 持 声名 式 事务 ， 即 使 用 注解 来 选择 需要 使 用 事务 
的 方法 ， 它 使 用 @Transactional 注 解 在 方法 上 表明 该 方法 需要 
事务 文 持 。 这 是 一 个 基于 AOP 的 实现 操作 ， 读 者 可 以 重 温 1.3.3 
节 中 使 用 注解 式 的 拦截 方式 来 理解 Spring 的 声名 式 事 务 。 被 注 
解 的 方法 在 被 调用 时 ，Spring 开 局 一 个 新 的 事务 ， 当 方法 无 弄 
常 运行 结束 后 ，Spring 会 提交 这 个 事务 。 





@Transactional 
public void saveSomething(Long id, String name) { 


// 数 据 库 操作 


在 此 处 需要 特别 注意 的 是 ， 此 @Transactional 注 解 来 自 
org.springframework.transaction.annotation 包 ， 而 不 是 
javax.transaction. 


Spring 提供 了 一 个 @EnableTransactionManagement 注 解 在 配 
置 类 上 来 开启 声名 式 事 务 的 支持 。 使 用 了 
@EnableTransactionManagement 后 ，Spring 容 器 会 自动 扫描 注 
解 @Transactional 的 方法 和 类 。@EnableTransactionManagement 
的 使 用 方式 如 下 : 





@Configuration 
@EnableTransactionManagement 
public class AppConfig { 


} 


8.4.3 ”注解 事务 行为 


@Transactional 有 如 表 8-4 所 示 的 属性 来 定制 事务 行为 。 
表 8-4 _@Transactional 的 属性 


m 性 含 x 默认 值 
propagationtion Propagation 定义 了 事务 的 生命 周期 ， 主 要 有 以 下 选项 REQUIRED 





REQUIRED: 方法 A 调用 时 没有 事务 新 建 一 个 事务 ， 当 在 方法 
A 调用 另外 一 个 方法 B 的 时 候 ， 方 法 B 将 使 用 相同 的 事务 ; 如 果 
方法 B 发 生 异常 需要 数据 回 深 的 时 候 ， 整 个 事务 数据 回 深 

REQUIRES_NEW: 对 于 方法 A fI B, 在 方法 调用 的 时 候 无 论 是 
否 有 事务 都 开启 一 个 新 的 事务 ; 这 样 如 果 方 法 B 有 异常 不 会 导致 
方法 A 的 数据 回廊 

NESTED: 和 REQUIRES_NEW 类 似 , 但 支持 JDBC, 不 支持 JPA 
或 Hibernate 

SUPPORTS: 方法 调用 时 有 事务 就 用 事务 ， 没 事务 就 不 用 事务 

NOT SUPPORTED: 强制 方法 不 在 事务 中 执行 ， 若 有 事务 ， 在 
方法 调用 到 结束 阶段 事务 都 将 会 被 挂 起 

NEVER: 强制 方法 不 在 事务 中 执行 ， 若 有 事务 则 抛 出 异常 

MANDATORY: 强制 方法 在 事务 中 执行 ， 若 无 事务 则 抛 出 异常 
isolation Isolation ( 隔离 ) 决定 了 事务 的 完整 性 ， 处 理 在 多 事务 对 相同 数 | DEFAULT 
据 下 的 处 理 机 制 , 主要 包含 下 面 的 隔离 级 别 ( 当然 我 们 也 不 可 以 随 
意 设 置 ， 这 要 看 当前 数据 库 是 否 支持 ) 

READ_UNCOMMITTED: 对 于 在 A 事务 里 修改 了 一 条 记录 但 没 
有 提交 事务 , 在 B 事务 可 以 读 取 到 修改 后 的 记录 。 可 导致 脏 读 、 
不 可 重复 读 以 及 幻 读 

READ COMMITTED: 只 有 当 在 A 事务 里 修改 了 一 条 记录 上 且 提 
交 事 务 之 后 , B 事务 才 可 以 读 取 到 提交 后 的 记录 ; 阻止 脏 
能 导致 不 可 重复 读 和 幻 读 
























































































m 性 = X 默认 值 
REPEATABLE READ: 不 仅 能 实现 READ_COMMITTED 的 功 
能 ， 而 且 还 能 阻止 当 A 事务 读 取 了 一 条 记录 ，B 事务 将 不 允许 修 
改 这 条 记录 ; 阻止 脏 读 和 不 可 重复 读 ， 但 可 出 现 幻 读 
isolation SERIALIZABLE; 此 级 别 下 事务 是 顺序 执行 的 , 可 以 避免 上 述 级 | DEFAULT 
别 的 缺陷 ， 但 开销 较 大 
DEFAULT: 使 用 当前 数据 库 的 默认 隔离 界 级 别 , 如 Oracle、 SQL 
Server 是 READ_COMMITTED; Mysql 是 REPEATABLE_READ 
timeout timeout 指定 事务 过 期 时 间 ， 默 认为 当前 数据 库 的 事务 过 期 时 间 | TIMEOUT_DEFAULT 
readOnly — 事务 是 否 是 只 读 事务 false 
rollbackFor KEMARA FS RT VÀ 5 pi SS TR Throwable 的 子 类 
noRollbackFor E 定 哪 个 或 者 哪些 异常 不 可 以 引起 事务 回 深 Throwable 的 子 类 








8.4.4 ”类 级 别 使 用 @Transactional 


@Transactional 不 仅 可 以 注解 在 方法 上 ， 也 可 以 注解 在 类 


上 EF。 当 注 解 在 类 上 的 时 候 意 味 着 此 类 的 所 有 public 方 法 都 是 开 
启事 务 的 。 如 果 类 级 别 和 方法 级 别 同时 使 用 了 @Transactional 
注解 ， 则 使 用 在 类 级 别 的 注解 会 重 载 方法 级 别 的 注解 。 











8.4.5 Spring Data JPA 的 事务 支持 





Spring Data JPA 对 所 有 的 默认 方法 都 开局 了 事务 文 持 ， 有 是 
查询 类 事务 默认 启用 readOnly=true 属 性 。 


这 些 我 们 在 SimpleJpaRepository 的 源码 中 可 以 看 到 ， 下 面 
就 来 看 看 缩减 的 SimpleJpaRepository 的 源码 : 








@Repository 

@Transactional(readOnly = true) 

public class SimpleJpaRepository<T, ID extends Serializable> 
JpaSpecificationExecutor<T> { 


@Transactional 

public void delete(ID id) {} 

@Transactional 

public void delete(T entity) {} 

@Transactional 

public void delete(Iterable<? extends T> entities) {} 
@Transactional 

public void deleteInBatch(Iterable<T> entities) {} 
@Transactional 

public void deleteAll() {} 

@Transactional 


public void deleteAllInBatch() {} 

public T findOne(ID id) {} 

@Override 

public T getOne(ID id) {} 

public boolean exists(ID id) {} 

public List<T> findAll() {} 

public List<T> findAll(Iterable<ID> ids) {} 
public List<T> findAll(Sort sort) {} 

public Page<T> findAll(Pageable pageable) {} 
public T findOne(Specification<T> spec) {} 
public List<T> findAll(Specification<T> spec) {} 


public Page<T> findAll(Specification<T> spec, Pageable pa 
public List<T> findAll(Specification<T> spec, Sort sort) 
public long count() {} 

public long count(Specification<T> spec) {} 
@Transactional 

public <S extends T> S save(S entity) {} 


@Transactional 

public <S extends T> S saveAndFlush(S entity) {} 
@Transactional 

public <S extends T> List<S> save(Iterable<S> entities) { 
@Transactional 

public void flush() {} 


从 源码 我 们 可 以 看 出 ，SimpleJpaRepository 在 类 级 别 定义 
J @Transactional (readOnly=true) ， 而 在 和 save、delete 相 关 
的 操作 重 写 了 @Transactional 属 性 ， 此 时 readOnly 属 性 是 false， 
其 余 查 询 操作 readOnly 仍 然 为 false。 





8.4.6 Spring Boot 的 事务 支持 





LA SAE SA ETE d 


在 使 用 JDBC 作 为 数据 访问 技术 的 时 候 ，Spring Boot 为 我 们 
定义 了 PlatformTransactionManager 的 实现 
DataSourceTransactionManager 的 Bean; 配置 见 
org.springframework.boot.autoconfigure.jdbc.DataSourceTransactic 


类 中 的 定义 : 








@Bean 

@ConditionalOnMissingBean 

QConditionalOnBean(DataSource.class) 

public PlatformTransactionManager transactionManager() (1 
return new DataSourceTransactionManager(this.dataSour 


在 使 用 JPA 作 为 数据 访问 技术 的 时 候 ，Spring ”Boot 为 我 们 
了 定义 一 个 PlatformTransactionManager 的 实现 
JpaTransactionManager 的 Bean; 配置 见 
org.Springframework.boot.autoconfigure.orm.jpa.JpaBaseConfigura 


类 中 的 定义 : 


@Bean 

QConditionalOnMissingBean(PlatformTransactionManager.clas 

public PlatformTransactionManager transactionManager() { 
return new JpaTransactionManager(); 

} 


2. 目 动 开 启 注解 事务 的 支持 
Spring Boot 专 门 用 于 配置 事务 的 类 为 : 


org.springframework.boot.autoconfigure.transaction. TransactionAu 
此 配置 类 依赖 于 JpaBaseConfiguration 和 DataSource 
TransactionManagerAutoConfiguration 。 


而 在 DataSourceTransactionManagerAutoConfiguration 配 置 
里 还 开局 了 对 声名 式 事 务 的 支持 ， 代 码 如 下 : 





@ConditionalOnMissingBean(AbstractTransactionManagementCo 
@Configuration 

@EnableTransactionManagement 

protected static class TransactionManagementConfiguration 


j 











所 以 在 Spring Boot 中 ， 无 须 显示 开局 使 用 
@EnableTransactionManagement 注 解 。 


8.4. ”实战 





在 实际 使 用 中 ， 使 用 Spring Boot 默 认 的 配置 就 能 满足 我 们 
绝 大 多 数 需 求 。 在 本 节 的 实战 里 ， 我 们 将 演示 如 何 使 用 
@Transactional 使 用 异常 导 任 数据 回 深 和 使 用 异常 让 数据 不 回 
TR o 

















1.3 £& Spring Bootlit H 


新 建 Spring Boot 项 目 ， 依 赖 为 JPA Cspring-boot-starter-data- 
jpa) 和 Web Cspring-boot-starter-web) . 


项 Hs B: 


groupId: com.wisely 
arctifactId:ch8 4 
package: com.wisely.ch8 4 


添加 Oracle JDBC 驱 动 ， 并 在 application.properties 配 置 相关 
属性 ， 与 上 例 保持 一 致 。 


2. 实 体 关 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity 
public class Person ( 


@Id 


QGeneratedValue 
private Long id; 


private String name; 
private Integer age; 
private String address; 


public Person() { 
super(); 
public Person(Long id, String name, Integer age, String a 
super(); 
this.id - id; 
this.name - name; 
this.age - age; 
this.address - address; 


} 
//B getter, setter 


3. 实 体 类 Repository 


import org.springframework.data.jpa.repository.JpaRepository; 
import com.wisely.ch8 4.domain.Person; 


public interface PersonRepository extends JpaRepository<Perso 


4.NV 4 AR Service 


(1) 服务 接口 : 


package com.wisely.ch8_4.service; 


import com.wisely.ch8_4.domain.Person; 


public interface DemoService { 
public Person savePersonWithRollBack(Person person); 
public Person savePersonWithoutRollBack(Person person); 


(2) 服务 实现 : 


package com.wisely.ch8 4.service.impl; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.stereotype.Service; 
import org.springframework.transaction.annotation.Transaction 


import com.wisely.ch8 4.dao.PersonRepository; 

import com.wisely.ch8 4.domain.Person; 

import com.wisely.ch8 4.service.DemoService; 

@Service 

public class DemoServiceImpl implements DemoService { 
@Autowired 
PersonRepository personRepository; //1 


@Transactional(rollbackFor= 
{IllegalArgumentException.class}) //2 
public Person savePersonWithRollBack(Person person) { 
Person p -personRepository.save(person); 


if(person.getName().equals("itz &"))( 
throw new IllegalArgumentException("iEa KOFE, 
数据 将 回 深 "); //3 
} 


return p; 


@Transactional(noRollbackFor= 
{IllegalArgumentException.class}) //4 
public Person savePersonWithoutRollBack(Person person) { 
Person p -personRepository.save(person); 


if (person.getName().equals("JEZ &"))[ 
throw new IllegalArgumentException("JEx KHUiff 





在 ， 数 据 将 不 会 回 深 "); 
} 


return p; 


代码 解释 
(可 以 直接 注入 我 们 的 RersonRepository 的 Bean。 


@ 使 用 @Transactional 注 解 的 rollbackFor 属 性 ， 指 定 特定 异 
常 时 ， 数 据 回 深 。 


(3) 便 编码 手动 触 友 异常 。 


(4) 使 用 @Transactional 注 解 的 noRollbackFor 属 性 ， 指 定 特定 
异常 时 ， 数 据 回 深 。 


5. 控 制 器 


package com.wisely.ch8_4.web; 


import 
import 
import 


org.springframework.beans.factory.annotation.Autowired 
org.springframework.web.bind.annotation.RequestMapping 
org.springframework.web.bind.annotation.RestController 


import com.wisely.ch8_4.domain.Person; 
import com.wisely.ch8_4.service.DemoService; 
@RestController 

public class MyController { 


@Autowired 
DemoService demoService; 


QRequestMapping("/rollback") 
public Person rollback(Person person){ //1 


return demoService.savePersonWithRollBack(person); 


@RequestMapping("/norollback" ) 
public Person noRollback(Person person) {//2 


return demoService.savePersonWithoutRollBack(person); 


代码 解释 

(测试 回 深情 况 。 

GO 测试 不 回 滚 情 况 。 

6. 运 行 

为 了 更 清楚 地 理解 回 深 ， 我 们 以 debug (调试 模式 ) 启动 
TZ. JffEDemoServiceImplll]savePersonWithRollBack7; i2;1] 
Er e e 

(1) 回 滚 


访问 http://localhost: 8080/rollback? name= 汗 云 飞 
&age=32， 调 试 至 savePersonWithRollBack 方 法 ， 如 图 8-50 所 
ZN o 














import com.wisely.ch8_4.domain.Person; 
import com.wisely.ch8_4.service.DemoService; 
@Service 
public class DemoServiceImpl implements DemoService { 
9 @Autowired 
PersonRepository personRepository; //1 

















" — 4 © p- Person (id=75) ^ 
|. áf(per| P * < 
th 目 address= null E 

} > g age= Integer (id=80) ig 

return 4 m id= Long (id=104) 3 


| of value= 27| 





Console X 二 





j84Application [Java | 


15-07-15 19:00:2 
15-07-15 19:00:2 








回 滚 


我 们 可 以 发 现 数据 已 保存 且 获 得 id 为 27。 继 续 执 行 抛 出 腊 
常 ， 将 导致 数 据 回 深 ， 如 图 8-51 所 示 。 


java.lang.TllegslArgumentéxception: 汪 云 飞 已 存在 , 数据 村 回流 


图 8-50 











at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 


我 们 查看 数据 库 ， 并 没有 新 增 数 据 ， 


com.wisely.ch8_4.service. impl.DemoServiceImpl.savePersonWithRollBack(DemoServiceImpl. java:21) 
sun.reflect.NativeMethodAccessorImpl.invokeQ(NHative Method) 
sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) 
sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) 

java. lang. reflect.Method. invoke(Unknown Source) 
org.springframework.aop.support.AopUtils.invokeJoinpointUsingReflection(AopUtils.java:302) 


org.springframework.aop.framework.ReflectiveMethodInvocation.invokeJoinpoint(ReflectiveMethodInvocstion.java:190) 





org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:157) 





org. springframework. transaction. interceptor .TransactionInterceptor$1.proceedWithInvocation(TransactionInterceptor. java:s 
org. springframework. transaction. interceptor. TransactionAspectSupport. invokeWithinTransaction(TransactionAspectSupport. js 


org. springframework. transaction. interceptor. TransactionInterceptor. invoke(TransactionInterceptor. java:96) 
org. springframework.aop. framework. ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation. java:179) 
org. springframework.aop. framework. JdkDynamicAopProxy . invoke(JdkDynamicAopProxy. java: 207) 


com. sun. proxy. $Proxy68.savePersonWithRollBack(Unknown Source) 
com wisely ch A weh MvConteallar rnl11harkrMvrontrnl1er iauas18Y 











图 8-51 ”数据 回 深 


如 图 8-52 所 示 。 





[select t.*, t.rowid from PERSON t 





8 | d 18 EJ] 
ID  |ADDRESS [AGE | NAME WID Bl 
1 合肥 32 EEG = J rr Z 
2|dR =| Aja : AAAESGAABAAAKhBAAB … 
3| 30 yy = AAAESGAABAAAKhBAAC -- 
4 RE … 22 = AAAESGAABAAAKhBAAD -- 
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Bg 


> 








28 aa - AAAESGAABAAAKhBAAE -- 
27 bb =| AAAESGAABAAAKhBAAF ~ 














Em UO & 1R Y " boot@XE JA 6 rows selected in 0 


图 8-52 ”未 新 增 数据 
(2) 不 回 滚 


访问 http://localhost: 8080/norollback? name= 汪 云 飞 
&age=32， 昌 然 我 们 也 抛 出 了 异常 ， 如 图 8-53 所 示 。 但 数据 并 
没有 回 演 ， 且 数据 库 还 新 增 了 一 条 记录 ， 如 图 8-54 所 示 。 


a.lang. -= ega zz ES = a ceptio at a Dp 
om.wisely.c ervice.impl.DemoServiceImpl.sa 








oniithoutRollBack(DemoSer' 








at 

at roti ct. - i veMethodAcci ve im ative e beth) 

at sun.reflect.NativeMethodAcc socii invoke (Unk own Sou 

at s fl 二 Impl.i voke(unknonn So ) 

at j lang.refl Method ke (Unknown 

at org.spi imework. aop. si parcat Las And odi UM pa aaa ction n(AopUtils.jav 302) 

at i aori op. framework. ReflectiveMethodInvocation. invokeJoinpoint(Refle erm ho i 
at org.springframework.aop.framework.ReflectiveMethodInv ae eed(ReflectiveMethodInvocation. E aum 








图 8-53 GEA ER 





select t.*, t.rowid from PERSON t 















































图 8-54 ”新 增 了 一 条 数据 


8.5 数据 缓存 Cache 


我 们 知 着 一 个 程序 的 瓶颈 在 于 数据 库 ， 我 们 也 知 趾 内 存 的 
速度 是 大 大 快 于 硬盘 的 速度 的 。 当 我 们 需要 重复 地 获取 相同 的 
数据 的 时 候 ， 我 们 一 次 又 一 次 的 请 求 数据 库 或 者 远程 服务 ， 导 
致 大 量 的 时 间 耗 费 在 数据 库 查 询 或 者 远程 方法 调用 上 ， 导 致 程 
序 性 能 的 恶化 ， 这 便 是 数据 缓存 要 解决 的 问题 。 














8.5.1 Spring 缓存 支持 


Spring 定义 了 org.springframework.cache.CacheManager 和 
org.springframework.cache.Cache 接 口 用 来 统一 不 同 的 缓存 的 技 
术 。 其 中 ，CacheManager 是 Spring 提供 的 各 种 绥 存 技术 抽象 接 
口 ，Cache 接 口 包含 绥 存 的 各 种 操作 《〈 增 加、 删除 、 获 得 组 
存 ， 我 们 一 般 不 会 直接 和 此 接口 打交道 ) 。 


1.Spring 文 持 的 CacheManager 


针对 不 同 的 缓存 技术 ， 需 要 实现 不 同 的 CacheManager， 
Spring 定义 了 如 表 8-5 所 示 的 CacheManager 实 现 。 


表 8-5 ”CacheManager 实 现 














CacheManager 





SimpleCache Manager 





ConcurrentMapCacheManager 








NoOpCacheManager 





EhCacheCacheManager 








FECE | er | OS | PS | rg 

















GuavaCacheM HJH Google Guava 的 GuavaCache 作为 缓存 技术 

HazelcastCacheM i 用 Hazelcast 作为 缓存 技术 

JCacheCacheManager 之 持 JCache( JSR-107 ) 标 准 的 实现 作为 缓存 技术 , 如 Apache Commons JCS 
RedisCacheM. 更 用 Redis 作为 缓存 技术 





在 我 们 使 用 任意 一 个 实现 的 CacheManager 的 时 候 ， 需 注册 
实现 的 CacheManager 的 Bean， 例 如 : 


@Bean 
public EhCacheCacheManager cacheManager(CacheManager ehCacheC 


return new EhCacheCacheManager ( ehcacheCacheManager ) ; 





当然 ， 每 种 缓存 技术 都 有 很 多 的 额外 配置 ， 但 配置 
cacheManager 是 必 不 可 少 的 。 
2. 声 名 式 缓 存 注解 
Spring 提供 了 4 个 注解 来 声明 缓存 规则 《又 是 使 用 注解 式 的 
AOP 的 一 个 生动 例子 ) 。 这 四 个 注解 如 表 8-6 所 示 。 
表 8-6 ”声明 式 缓存 注意 


to 解 解 R 
@Cacheable 在 方法 执行 前 Sprin; 存 中 是 否 有 数据 ， 如 果 有 数据 ， 则 直接 返回 缓存 数据 ; 若 没 有 数 
据 ， 调 用 方法 并 将 方 



























@CachePut ACER, 2 





BE BAF URS 


@CacheEvict 将 一 条 或 











@Caching 可 以 通过 @Caching 注解 组 合 多 个 注解 策略 在 一 个 方法 上 


@Cacheable、@CachePut、@CacheEvit 都 有 value 属 性 ， 指 
定 的 是 要 使 用 的 缓存 名 称 ; key 属 性 指定 的 是 数据 在 缓存 中 的 
存储 的 键 。 


3. 开 启 声名 式 缓 存 文 持 


开 司 声名 式 缓存 文 持 十 分 简单 ， 只 需 在 配置 类 上 使 用 
@EnableCaching 注 解 即 可 ， 例 如 : 











@Configuration 
@EnableCaching 
public class AppConfig { 


} 


8.5.2 Spring Boot 的 支持 








在 Spring 中 使 用 绥 存 技术 的 关键 是 配置 CacheManager， 而 
Spring Boot 为 我 们 目 动 配置 了 多 个 CacheManager 的 实现 。 


Spring Boot 的 CacheManager 的 自动 配置 放置 在 
org.springframework.boot.autoconfigure.cache 包 中 ， 如 图 8-55 所 
不 。 








E 出 cache 
> i8 CacheAutoConfiguration.class 

. fy CacheCondition.class 
ts CacheConfigFileCondition.class 

- tm CacheConfigurations.class 

- $å CacheProperties.class 

! CacheType.class 
hy EhCacheCacheConfiguration.class 
ta GenericCacheConfiguration.class 
tà GuavaCacheConfiguration.class 

. tg HazelcastCacheConfiguration.class 

» Tap InfinispanCacheConfiguration.class 

> tm JCacheCacheConfiguration.class 


- $9 JCacheManagerCustomizer.class 
. fy NoOpCacheConfiguration.class 

. tg) RedisCacheConfiguration.class 

. tg SimpleCacheConfiguration.class 





图 8-55 ”CacheManager 的 自动 配置 


通过 图 8-56 我 们 可 以 看 出 ，Spring ” Boot 为 我 们 自动 配置 了 
EhCacheCacheConfiguration 〈 使 用 EhCache) 、 
GenericCacheConfiguration 〈 使 用 Collection) 、 
GuavaCacheConfiguration 〈 使 用 Guava) 、 
HazelcastCacheConfiguration 〈 使 用 Hazelcast) 、 
InfinispanCacheConfiguration 〈 使 用 Infinispan ) ~ 
JCacheCacheConfiguration 〈 使 用 JCache) 、 
NoOpCacheConfiguration 〈 不 使 用 存储 ) 、 
RedisCacheConfiguration 〈 使 用 Redis) 、 
SimpleCacheConfiguration 〈 使 用 ConcurrentMap) 。 在 不 做 任 
何 额 外 配置 的 情况 下 ， 默 认 使 用 的 是 


SimpleCacheConfiguration, B[f Hj 
ConcurrentMapCacheManager. Spring 


以 “spring.cache” 为 前 级 的 属性 来 配置 缓存 。 


spring.cache. 
generic, ehcache, 


spring.cache 


spring.cache. 
spring.cache. 
spring.cache. 
spring.cache. 
spring.cache. 


type= 


ehcache.config= # 


infinispan.config= 


jcache.config= # 
jcache.provider- 


候 ， 指 定 jcache 实 现 


spring.cache.guava.spec= # guava specs 


# 





Boot xz FF 


可 选 


hazelcast, infinispan, jcache, redis, # gua 
.cache-names- # 程序 启动 时 创建 缓存 名 称 


ehcache 配 置 文件 地 址 
hazelcast.config- # hazelcast 配置 文件 地 址 

# infinispan 配置 文件 地 址 
jcache 配置 文件 地 址 


# 当 多 个 





























jcache 实 现在 类 路 径 中 的 时 





在 Spring Boot 环 境 下 ， 使 用 缓存 技术 只 需 在 项 目 中 导入 相 
关 绥 存 技 术 的 依赖 包 ， 并 在 配置 类 使 用 @EnableCaching 开 局 组 





AF SCHEER HY 


8.5.3 ”实战 


本 例 将 以 Spring BootE iA ConcurrentMapCacheManagerTE 
为 缓存 技术 ， 演 示 @Cacheable、@CachePut、@CacheEvit， 最 





后 使 用 EhCache、Guava 来 蔡 换 缓存 技 术 。 


1. 新 建 Spring Boot 项 目 


新 建 Spring 


项 Hs B: 


Boot 项 目 ， 依 赖 为 Cache (spring-boot-starter- 
cache) 、JPA (spring-boot-starter-data-jpa) 和 Web (spring- 
boot-starter-web) 。 


groupId: com.wisely 
arctifactId:ch8 5 
package: com.wisely.ch8 5 


添加 Oracle JDBC 驱 动 ， 并 在 application.properties 配 置 相关 
属性 ， 与 上 例 保持 一 致 。 


2. 实 体 类 


package com.wisely.ch8_5.domain; 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity 

public class Person ( 
QId 
QGeneratedValue 
private Long id; 


private String name; 
private Integer age; 
private String address; 
public Person() { 
super(); 
public Person(Long id, String name, Integer age, String a 
super(); 
this.id - id; 
this.name - name; 
this.age - age; 


this.address - address; 


} 
//@i&getter, setter 


3. 实 体 类 Repository 


package com.wisely.ch8_5.dao; 
import org.springframework.data.jpa.repository.JpaRepository; 
import com.wisely.ch8 5.domain.Person; 


public interface PersonRepository extends JpaRepository<Perso 


4. 业 务 服务 


(1) 接口 : 


package com.wisely.ch8_5.service; 
import com.wisely.ch8_5.domain.Person; 


public interface DemoService { 
public Person save(Person person); 


public void remove(Long id); 


public Person findOne(Person person); 


(2) 实现 类 : 


package com.wisely.ch8 5.service.impl; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.cache.annotation.CacheEvict; 
import org.springframework.cache.annotation.CachePut; 


import 
import 


import 
import 
import 


org. 
.springframework.stereotype.Service; 


org 


com 


com. 
.Wisely.ch8 5.service.DemoService; 


com 


@Service 
public class DemoServiceImpl implements DemoService { 
@Autowired 
PersonRepository personRepository; 


springframework.cache.annotation.Cacheable; 


.Wisely.ch8 5.dao.PersonRepository; 


wisely.ch8 5.domain.Person; 


QOverride 

@CachePut(value = "people",keyz"Zperson.id") //1 

public Person save(Person person) ( 

Person p - personRepository.save(person); 
System.out.println("7jid. keyW:"+p. getId()+" 数 据 做 了 组 


t"); 
j 


return p; 


QOverride 

QCacheEvict(value - "peopele") //2 

public void remove(Long id) ( 
System.out.println( "JWR fid. key" +id+" WAGER"); 
personRepository.delete(id); 


} 


@Override 

@Cacheable(value="people", key="#person.id") //3 

public Person findOne(Person person) { 

Person p = personRepository.findOne(person.getId()); 
System.out.println("7jid. keyA:"+p.getId( )+" Ase tit f 2X 


t"); 
j 


return p; 


代码 解释 
@@Cacheput 缓 存 新 增 的 或 更 新 的 数据 到 缓存 ， 其 中 缓存 


名 称 为 people， 数 据 的 key 是 person 的 id。 
@@CacheEvict 从 缓存 people 中 删除 key 为 id 的 数据 。 
(3)@Cacheable2z ff key NpersonMid AH Fi] ££ people # 。 


这 里 特别 说 明 下 ， 如 果 没 有 指定 key， 则 方法 参数 作为 key 
保存 到 绥 存 中 。 


5. 控 制 器 


package com.wisely.ch8_5.web; 
import org.springframework.beans.factory.annotation.Autowired 


import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RestController 


import com.wisely.ch8_5.domain.Person; 
import com.wisely.ch8_5.service.DemoService; 


@RestController 
public class CacheController { 


@Autowired 
DemoService demoService; 


QRequestMapping("/put") 


public Person put(Person person)( 
return demoService.save(person); 


QRequestMapping("/able") 
public Person cacheable(Person person)( 


return demoService.findOne(person); 


j 


QRequestMapping("/evit") 
public String evit(Long id){ 


B 


到 ， 


demoService.remove(id); 
return "ok"; 


6.JFJ8 ZEE CE 


package com.wisely.ch8 5; 

import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootAppli 
import org.springframework.cache.annotation.EnableCaching; 
QSpringBootApplication 

QEnableCaching 

public class Ch85Application ( 


public static void main(String[] args) { 
SpringApplication.run(Ch85Application.class, args); 


代码 解释 
在 Spring Boot 中 还 是 要 使 用 @EnableCaching 开 局 绥 存 文 





7. 运 行 


当 我 们 对 数据 做 了 缓存 之 后 ， 数 据 的 获得 将 从 绥 存 中 得 
而 不 是 从 数据 库 中 得 到 。 当 前 的 数据 库 的 数据 情况 如 图 8- 


56 上 所 示 。 


Š =@ 


SQL | Output | Statistics 





select t.*, t.rowid from PERSON t 


A e 4H 


AAAESGAABAAAKhBAAA -- 
31x … AAAESGAABAAAKhBAAB … 
30 yy ^ AAAESGAABAAAKhBAAC ~ 
29 zz … AAAESGAABAAAKhBAAD -- 
28 aa — AAAESGAABAAAKhBAAE ~ 
27 bb — - AAAESGAABAAAKhBAAF ~ 








€ 














v boot@XE -网 6 rows selected in 0.015 


图 8-56 ”当前 数据 库 的 数据 情况 





我 们 在 每 次 运行 测试 情况 下 ， 都 重启 了 应 用 程序 。 


(1) 测试 @Cacheable 


第 一 次 访问 http://localhost: 8080/able? id=1, 
用 方法 得 询 数据 库 ， 并 将 数据 放 到 缓存 people 中 。 


此 时 控制 台 输 出 如 下 : 


2015-07-17 13:26:38.543 INFO 2696 --- [ 

2015-07-17 13:29:22.979 INFO 2696 --- [nio-8088 
2015-07-17 13:29:22.979 INFO 2696 --- [nio-8080 
2015-07-17 13:29:23.007 INFO 2696 --- [nio-8080 


Hibernate: select personO .id as id1_@ 0 , perso 


为 id key: AWB TiETE 


页 面 输出 如 图 8-57 所 示 。 


a= 


/ @ localhost:8080/able?id= x m -_—- 





C | D localhost8080/able?id-1 


Lis 
i . 30 





图 8-57 ”页面 输出 结果 


再 次 访问 http:/localhost: 8080/able? id=1， 此 时 控制 台 没 


有 再 次 输出 Hibermate 的 查询 语句 ， 以 及 “为 d、keywei: 1 数据 
做 了 缓存 字样， 表示 没有 调用 这 个 方法 ， 页 面 直接 从 数据 绥 








存 中 获得 数据 。 
页 面 输出 结果 如 图 8-58 所 示 。 





/ @ localhost:8080/able?id= x W | 
| € C | [5localhost:8080/able?id-1 


i . 





图 8-58 ”页 面 输出 结 


(2) 测试 @CachePut 
访问 http:Wlocalhost: 8080/put? name-cc&age-22&address- 


成 都 ， 此 时 控制 合 输出 如 下 : 


Hibernate: select hibernate_sequence.nextval from dual 
Hibernate: insert into person (address, age, name, id) values (?, ?, ?, ?) 


为 id、key 为 :62 数 据 做 了 绎 存 


页 面 输出 如 图 8-59 所 示 。 


( ~~ E ES ~ | co |) mm 
@ localhost:8080/put?nan x V -— a — 


€ C | [5localhost:8080/put?name-cc&: 7? | = 


{ 





图 8-59 测试 @CachePut 
我 们 再 次 访问 http: //localhost: 8080/able? id=62, 控制 台 无 
输出 ， 从 缓存 直接 获得 数据 ， 页 面 显示 如 图 8-59 所 示 。 
(3) 测试 @CacheEvit 


访问 http://localhost: 8080/able? id=1， 为 id 为 1 的 数据 做 组 
存 ， 再 次 访问 http://localhost: 8080/able? id=1， 确 认 数 据 已 从 


BAF PARR 


访问 http://localhost: 8080/evit? id=1, M2744 FH RkeyA 
1 的 绥 存 数据 : 








2015-07-17 14:38:40.847 INFO 3360 --- [nio-8080-exec-1] o.s.web.se 

peg pn select person@_.id as| id1 8 8 , person € pers ress as addres 
ey Ay: $R T ETF 

Coen key AQ SAREE | 








再 次 访问 http:/localhost: 8080/able? id=1， 观 察 控制 台 重 
新 做 了 绥 存 : 


Hibernate: select person9_ .id as id1 00, persona 
为 1d、key 为 :1 数据 做 了 绎 存 
星 除 了 id 、key 为 1 的 数据 绎 存 
Hibernate: select person@_.id as idl 0 0 , person@ 


aid 、key 为 :1 数据 做 了 经 存 | 











页 面 显示 如 图 8-58 所 示 。 


8.5.4 ”切换 缓存 技术 








切换 缓存 技术 除了 移入 相关 依赖 包 或 者 配置 以 外 ， 使 用 方 
式 和 实战 例子 保持 一 致 。 下 面 简 要 讲解 在 Boot 下 ， 
mu Guava 作 为 缓存 技术 的 方式 ， 其 余 绥 存 技 术 也 是 类 
UB; T 


1.EhCache 


当 我 们 需要 使 用 EhCache 作 为 缓存 技术 的 时 候 ， 我 们 只 需 
在 pom.xml 中 添加 EhCache 的 依赖 即 可 : 











<dependency> 
<groupId>net.sf.ehcache</groupId> 
<artifactId>ehcache</artifactId> 
</dependency> 


EhCache 所 需 的 配置 文件 ehcache.xml 只 需 放 在 类 路 径 下 ， 
Spring Boot 会 自动 扫描 ， 例 如 : 


<?xml version="1.0" encoding="UTF-8"?> 
<ehcache> 
<cache name="people" maxElementsInMemory="1000" /> 


</ehcache> 


Spring ”Boot 会 给 我 们 自动 配置 EhCacheCacheManager 的 
Bean. 


2.Guava 


当 我 们 需要 使 用 Guava 作 为 缓存 技术 的 时 候 ， 我 们 也 只 需 
在 pom.xml 中 增加 Guava 的 依赖 即 可 : 








<dependency> 
<groupId>com.google.guava</groupId> 
<artifactId>guava</artifactId> 
<version>18.0</version> 
</dependency> 


Spring Boot 会 给 我 们 自动 配置 GuavaCacheManager 这 个 
Bean. 


3.Redis 
使 用 Redis， 只 需 添 加 下 面 的 依赖 即 可 : 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
redis</artifactId> 
</dependency> 


Spring ”Boot 将 会 为 我 们 自动 配置 RedisCacheManager 以 及 
RedisTemplateff Bean. 


8.6 ” 非 天 系 型 数据 库 NoSQL 


NoSQL 是 对 于 不 使 用 关系 作为 数据 管理 的 数据 库 系 统 的 统 
称 。NoSQL 的 主要 特点 是 不 使 用 SQL 语言 作为 查询 语 言 ， 数 据 
存储 也 不 是 固定 的 表 、 字 段 。 


NoSQL 数 据 库 主 要 有 文档 存储 型 (MongoDB) 、 图 形 关系 
存储 型 〈Neo4j ) 和 键 值 对 存储 型 (Redis) 。 


本 节 将 演示 基于 MongoDB 的 数据 访问 以 及 基于 Redis 的 数 
据 访问 。 








8.6.1 MongoDB 


MongoDB 是 一 个 基于 文档 (Document) 的 存储 型 的 数据 
库 ， 使 用 面 癌 对 象 的 思想 ， 每 一 条 数据 记录 都 是 文档 的 对 象 。 


在 本 市 我 们 不 会 介绍 太 多 关于 MongoDB 数 据 库 本 里 的 知 
识 ， 本 节 主 要 讲述 Spring 及 Spring Boot 对 MongoDB 的 支持 ， 以 
及 基于 Spring Boot 和 MongoDB 的 实战 例子 。 

1.Spring 的 文 持 


Spring 对 MongoDB 的 文 持 主要 是 通过 Spring Data MongoDB 
来 实现 的 ，Spring Data MongoDB 为 我 们 提供 了 如 下 功能 。 


(1) Object/DocumentHR AY Y= fE sc FF 




















JPA 提 供 了 一 套 ObjecVRelation 映 射 的 注解 (@Entity, 


@Id) ， 而 Spring Data MongoDB 也 提供 了 表 8-7 所 示 的 注解 。 
8-7 TEP 


È f 描 R 


@Document 映射 领域 对 象 与 MongoDB 的 一 个 文档 








@Id 映射 当前 属性 是 也 





@DbRef 当前 属性 将 参考 其 他 的 文档 
@Field 为 文档 的 属性 定义 名 称 








@Version 将 当前 属性 作为 版 本 





(2) MongoTemplate 


f&JdbcTemplate— T£, Spring Data MongoDB 也 为 我 们 提供 
了 一 个 MongoTemplate，MongoTemplate 为 我 们 提供 了 数据 访 
问 的 方法 。 我 们 还 需要 为 MongoClient 以 及 MongoDbFactory 来 
配置 数据 库 连接 属性 ， 例 如 : 





@Bean 
public MongoClient client() throws UnknownHostException { 


MongoClient client = new MongoClient(new ServerAddres 
return client; 


@Bean 

public MongoDbFactory mongoDbFactory() throws Exception { 
String database = new MongoClientURI("mongodb://local 
return new SimpleMongoDbFactory(client() , database); 


@Bean 

public MongoTemplate mongoTemplate(MongoDbFactory mongoDb 
return new MongoTemplate(mongoDbFactory); 

} 


(3) Repository HY) x E 


类 似 于 Spring Data JPA, Spring Data MongoDB 也 提供 了 
Repository 的 支持 ， 使 用 方式 和 Spring Data JPA 一 致 ， 定 义 如 
下 : 


public interface PersonRepository extends MongoRepository<Per 


} 





类 似 于 Spring Data ”JPA 的 开启 文 持 方式 ，MongoDB 的 
Repository 的 文 持 开局 需 在 配置 类 上 注解 
@EnableMongoRepositories， 例 如 : 





@Configuration 
@EnableMongoRepositories 
public class AppConfig { 


j 


2.Spring Boot 的 支持 


Spring Boot 对 MongoDB 的 文 持 ， 分 别 位 于 : 


org.springframework.boot.autoconfigure.mongo 


主要 配置 数据 库 连 接 、MongoTemplate。 我 们 可 以 使 用 
以 “spring.data.mongodb” 为 前 缀 的 属性 来 配置 MongoDB 相 关 的 
信息 。Spring Boot 为 我 们 提供 了 一 些 默认 属性 ， 如 默认 
MongoDB 的 端口 为 27017、 默 认 服 务 器 为 localhost、 默 认 数 据 
库 为 test。Spring Boot 的 主要 配置 如 下 : 





spring.data.mongodb.host= # 数据 库 主机 地 址 ， 默 认 localhost 
spring.data.mongodb.port=27017 s 数据 库 连 接 端口 默认 27107 
spring.data.mongodb.uri=mongodb://localhost/test # connection 
spring.data.mongodb.database= 
spring.data.mongodb.authentication-database- 
spring.data.mongodb.grid-fs-database- 
spring.data.mongodb.username- 

spring.data.mongodb.password- 
spring.data.mongodb.repositories.enabled-true #repository 支 持 
是 否 开启 ， 默 认为 已 开启 

spring.data.mongodb.field-naming-strategy- 
org.springframework.boot.autoconfigure.data.mongo 








为 我 们 开启 了 对 Repository 的 支持 ， 即 目 动 为 我 们 配置 了 
@EnableMongoRepositories. 


所 以 我 们 在 Spring ^ Boot F fii FH MongoDB H fi 5| A spring- 
boot-starter-data-mongodb 依 赖 即 可 ， 无 须 任何 配置 。 


3. 实 战 
(1) 安装 MongoDB 


1) 非 Docker 安 装 。 若 不 使 用 Docker 作 为 安装 方式 ， 则 我 们 
可 以 访问 https://www.mongodb.org/downloads 来 下 载 适 合 自 己 
当前 操作 系统 的 版 本 来 安装 MongoDB。 


2) Docker 安 装 。 前 面 已 经 下 载 好 了 MongoDB 的 Docker 镜 
像 ， 接 下 来 需 通 过 下 面 命令 运行 Docker 容 器 : 





docker run -d -p 27017:27017 mongo 


运行 好 以 后 ， 记 得 在 VirtualBox 再 做 一 次 端口 映射 ， 如 图 8- 
60 所 示 。 





127.0.0.1 





127.0.0.1 


127.0.0.1 


127.0.0.1 




















图 8-60 “端口 映射 


MongoDB 数 据 库 管 理 软件 可 使 用 Robomongo， 下 载 地 址 是 
http://www.robomongo.org， 如 图 8-61 所 示 。 


View Options Window Help 


BS ald > wo 
4 (mi localhost (2) 
> js System 


> B test 














图 8-61 Robomongo 界 面 


(2) 搭建 Spring Boot 项 目 


搭建 Spring Boot 项 目 ， 依 赖 为 MongoDB (spring-boot- 
starter-data-mongodb) 和 Web (spring-boot-starter-web) 。 


项 H fe A : 


groupId: com.wisely 
arctifactId:ch8 6 1 
package: com.wisely. ch8 6 1 


因为 Spring Boot 的 默认 数据 库 连 接 满足 我 们 当前 测试 的 要 
求 ， 所 以 将 不 在 为 application.properties 配 置 连接 信息 。 


(3) 领域 模型 


本 例 的 领域 模型 是 人 (Person) ， 包 含 他 工作 过 的 地 点 
(Location) 。 这 个 虽然 和 关系 型 数据 库 的 一 对 多 类 似 ， 但 还 
是 不 一 样 的 ，Location 的 数据 只 属于 某 个 人 。 


Person} fi : 


package com.wisely.ch8_6_1.domain; 


import java.util.Collection; 
import java.util.LinkedHashSet; 


import org.springframework.data.annotation.Id; 
import org.springframework.data.mongodb.core.mapping.Document 


@Document //1 
public class Person { 
@Id //2 
private String id; 
private String name; 
private Integer age; 
@Field("locs")//3 
private Collection<Location> locations = new LinkedHashS 


(); 


public Person(String name, Integer age) { 
super(); 
this.name - name; 
this.age - age; 





} 
// 省 略 getter、setter 方 法 
} 


代码 解释 
(D@Document 注 解 映射 领域 模型 和 MongoDB 的 文档 。 
CO@Id 注 解 表 明 这 个 属性 为 文档 的 Id。 


(3@Field 注 解 此 属性 在 文档 中 的 名 称 为 locs，locations 属 性 
将 以 数组 形式 存在 当前 数据 记录 中 。 


Location f: 








package com.wisely.ch8 6 1.domain; 
public class Location ( 
private String place; 


private String year; 

public Location(String place, String year) ( 
super(); 
this.place - place; 
this.year - year; 





} 
// 省 略 getter、setter 方 法 


j 


(4) 数据 访问 : 


package com.wisely.ch8_6_1.dao; 
import java.util.List; 


import org.springframework.data.mongodb.repository.MongoRepos 
import org.springframework.data.mongodb.repository.Query; 


import com.wisely.ch8 6 1.domain.Person; 


public interface PersonRepository extends MongoRepository<Per 


Person findByName(String name); //1 


@Query("{'age': ?0}") //2 
List<Person> withQueryFindByAge(Integer age); 


代码 解释 

QD 支持 方法 名 查询 。 

@ 文 持 @Query 查 询 ， 碍 询 参数 构造 JSON 字 符 串 即 可 。 
(5) 控制 器 : 





package com.wisely.ch8_6_1.web; 


import 
import 
import 
import 
import 
import 
import 
import 
import 


java.util.Collection; 
java.util.LinkedHashSet; 
java.util.List; 


org 


com 
com 
com 


.springframework.beans.factory.annotation.Autowired 
org. 
org. 


springframework.web.bind.annotation.RequestMapping 
springframework.web.bind.annotation.RestController 


.Wisely.ch8 6 1.dao.PersonRepository; 
.Wisely.ch8 6 1.domain.Location; 
.Wisely.ch8 6 1.domain.Person; 


QRestController 
public class DataController ( 


QAutowired 
PersonRepository personRepository; 


QRequestMapping("/save") //1 

public Person save(){ 

Person p - new Person("wyf",32); 
Collection<Location> locations = new LinkedHashSet<L 


(); 


Location loci 
Location loc2 
Location loc3 


new Location(" LFifj","2009"); 
new Location("4JE","2010"); 
new Location("/] ^|","2011"); 


Location loc4 = new Location("4 &ilj","2012"); 
locations.add(loci); 

locations.add(loc2); 

locations.add(loc3); 

locations.add(loc4); 
p.setLocations(locations); 

return personRepository.save(p); 


} 


@RequestMapping("/qi") //2 
public Person qi(String name){ 

return personRepository.findByName(name); 
} 


@RequestMapping("/q2") //3 
public List<Person> q2(Integer age) { 

return personRepository.withQueryFindByAge(age); 
} 


代码 解释 

QD 测试 保存 数据 。 

测试 方法 名 查询 。 

@) 测 试 @Query 查 询 。 

(6) 运行 

测试 保存 数据 

访问 http://localhost: 8080/save 测 斌 保存， 页面 如 图 8-62 所 


/ @ localhost:8080/save x WN 


| € C | D localhost:8080/save ?7 = 


wow 


ions”: [{"place” :* E38", "year" :“2009°}, ['place":" E 
BD", "year" :"2010"], l'Dlace":"J Jl", "year" :" 2011", 
{"place":“ 马 鞍山 ", "year": "2012"1]] 


{"id" :" 55ab3cc49e006c33fab5d fa", "name" :“wyrt", “age” :32, "locat 





图 8-62 ”测试 保存 
我 们 可 以 在 Robomongo 中 查看 保存 后 的 数据 ， 如 图 8-63 所 





Key Value Type 
4 &3 (1) Objectid("55ab3cc49e006c33fab5dffa") {5 fields } 
5 id Objectid("55ab3cc49e006c33fabSdffa") 
= class com.wisely.ch8 6 1.domain.Person 
" name wyf 
age 32 
© locs Array [4] 
&» 0 (2 fields ) 
pl 上 海 
yea 2 
@i1 ( 2 fields ) 
" pla a 
5 yea 2010 
&»2 {2 fields ) 
"| pla 广州 
5 yea 2011 
@3 (2 fields ) 
pl BEU 
y 2012 











图 8-63 得 看 保存 后 的 数据 
测试 方法 名 查询 


访问 http://localhost: 8080/q1? name=wyf， 页 面 结果 如 图 8- 
64 所 示 。 


测试 @Query 查 询 


访问 http://localhost: 8080/q2? age=32， 页 面 结果 如 图 8-65 
所 示 。 


PI localhost:8080/q1?narr 
€ > QC [5localhost8080/g1?name-wyf v? = 








id: “55ab3cc49e006c33fab5df fa", "name" :“wyf", “age” :32, “locat 
ions" : [ place" i" £33", "year" :" 2009"], "place" vt 

IE", "year^:"2010"], l'place": d year": "2011", 

l'place":" BRU", “year“:“2012°}]} 











图 8-64 ”测试 方法 名 查询 


@ localhost:8080/q2?age- x WE 
€ > Q |D localhost:8080/q2?age=32 YY 


[{" id": “SSab3ecd9e006033£ abbdff a" , "name" : “wyf", "age" :32, " loca 
tions": ['place":" E38", "year" : "2009" ], E place":"& 








R^," year": " 2010"), l'place":" JJ", "year" :" 20117], 
l'place": "B8 l|", "year" :"2012"111] 











图 8-65 测试 @Query 碍 询 


8.6.2 Redis 
Redis 是 一 个 基于 键 值 对 的 开源 内 存 数 据 存 储 ， 当 然 Redis 
也 可 以 做 数据 缓存 〈 见 8.5.4 节 ) 
1.Spring 的 文 持 
CD 配置 





Spring 对 Redis 的 文 持 也 是 通过 Spring Data Redis 来 实现 的 ， 
Spring Data JPA 为 我 们 提供 了 连接 相关 的 ConnectionFactory 和 
数据 操作 相关 的 RedisTemplate。 在 此 特别 指出 ，Spring Data 
Redis 只 对 Redis 2.6 和 2.8 版 本 做 过 测试 。 


根据 Redis 的 不 同 的 Java 客 户 端 ，Spring Data Redis 提 供 了 如 
下 的 ConnectionFactory: 





JedisConnectionFactory: 使 用 Jedis 作 为 Redis 客 户 端 。 
JredisConnectionFactory: 使 用 Jredis 作 为 Redis 客 户 端 。 
LettuceConnectionFactory: 使 用 Lettuce 作 为 Redis 客 户 端 。 


SrpConnectionFactory: 4% 4 Spullara/redis-protocol/F A 
Redis# 1 Ùi o 


配置 方式 如 下 : 


@Bean 
public RedisConnectionFactory redisConnectionFactory() { 
return new JedisConnectionFactory(); 


RedisTemplate 配 置 方式 如 下 : 


@Bean 
public RedisTemplate<Object, Object» redisTemplate()throw 
RedisTemplate<Object, Object» template = new RedisTem 
07 
template.setConnectionFactory(redisConnectionFactory( 
return template; 


(2) 使 用 


Spring Data Redis 为 我 们 提供 了 RedisTemplate 和 
StringRedisTemplate 两 个 模板 来 进行 数据 操作 ， 其 中 ， 
StringRedisTemplate 只 针对 键 值 都 是 字符 型 的 数据 进行 操作 。 


RedisTemplate 和 StringRedisTemplate 提 供 的 主要 数据 访问 
方法 如 表 8-8 所 示 。 








表 8-8 数据 访问 方法 


5 X 说 — BB 
有 简单 属性 的 数据 




















更 多 关于 Spring Data Redis 的 操作 ， 请 但 看 Spring Data 
Redis 官 方 文档 。 
(3) 定义 Serializer 


当 我 们 的 数据 存储 到 Redis 的 时 候 ， 我 们 的 键 〈key) AU 
(value) 都 是 通过 Spring 提供 的 Serializer 序 列 化 到 数据 库 的 。 
RedisTemplate 默 认 使 用 的 是 JdkSerializationRedisSerializer， 
StringRedisTemplate 默 认 使 用 的 是 StringRedisSerializer。 


Spring Data JPA 为 我 们 提供 了 下 面 的 Serializer: 





GenericToStringSerializer 、Jackson2JsonRedisSerializer、 
JacksonJsonRedisSerializer. JdkSerializationRedisSerializer, 
OxmSerializer, StringRedisSerializer. 


2.Spring Booth x 4f 
Spring Boot 对 Redis 的 支持 ， 


org.springframework.boot.autoconfigure.redis #4, 4] 18-66 FIT AS © 


4 出 redis 


tip RedisAutoConfiguration.class 





- tib RedisProperties.class 


图 8-66 ”Redis 包 


RedisAutoConfiguration 为 我 们 默认 配置 了 
JedisConnectionFactory、RedisTemplate 以 及 
StringRedisTemplate， 让 我 们 可 以 直接 使 用 Redis 作 为 数据 存 
储 。 


RedisProperties 回 我 们 展示 了 可 以 使 用 以 “spring.redis” 为 前 
级 的 属性 在 application.properties 中 配置 Redis， 主 要 属性 如 下 : 








spring.redis.database= 04 数据 库 名 称 ， 默 认为 db0 
spring.redis.host-localhost # 服 务 器 地 址 ， 默 认为 localhostt 
spring.redis.password- # 数据 库 密码 d 
spring.redis.port=6379 £s 连接 端口 号 ， 默 认为 6379 
spring.redis.pool.max-idle=8 s 连接 池 设 置 
spring.redis.pool.min-idle=0 
spring.redis.pool.max-active-8 
spring.redis.pool.max-wait--1 
spring.redis.sentinel.master- 
spring.redis.sentinel.nodes- 
spring.redis.timeout- 

















3.5 AX 
(1) 安装 Redis 


1) 非 Docker 安 装 。 知 不 基于 Docker 安 装 的 话 ， 我 们 可 以 到 
http:/redis.io/download 下 载 合适 版 本 的 Redis。 注 意 不 要 下 载 最 


新 版 本 的 3.0.x 版 本 。 


2) Docker 安 装 。 前 面 我 们 已 经 下 载 好 了 Redis 镜 像 ， 通 过 
下 面 命令 运行 容器 : 





docker run -d -p 6379:6379 redis:2.8.21 


并 在 VirtualBox 配 置 端口 映射 ， 如 图 8-67 所 示 。 








主机 IP 子 系统 满口 Qs 
127.0.0.1 27017 e 


127.0.0.1 1521 
127.0.0.1 22 
9090 


127.0.0.1 
€ zum 























图 8-67 ”端口 映射 


Redis 数 据 管理 可 以 使 用 Redis Client， 下 载 地 址 为 
https://github.com/caoxinyu/RedisClient， 这 是 一 个 可 以 独立 运 
行 的 jar 包 ， 如 图 8-68 所 示 。 


S& RedisClient 





Server Data View Tools Favorites Help 


[€ o © localhost: 
4 E Redis servers a SA Redis data explorer 


4 i localhost 


Name Type 

É db0 Database 
É dbi Database 
É db2 Database 
E db3 Database 
4 m 














图 8-68  RedisClient 
(2) 新 建 Spring Boot 项 目 


搭建 Spring ^ Boot 项目， 依赖 为 Redis (spring-boot-starter- 
redis) 和 Web (spring-boot-starter-web) . 


项 H 信 A : 


groupId: com.wisely 
arctifactId:ch8 6 2 
package: com.wisely. ch8 6 2 


为 Spring Boot 的 默认 数据 库 连 接 满 足 我 们 当前 测试 的 要 
所 以 无 须 不 在 application.properties 配 置 连接 信息 。 


(3) 领域 模型 类 ; 


Ch 
i 
-> 


package com.wisely.ch8 6 2.dao; 


import java.io.Serializable; 


public class Person implements Serializablef{ 
private static final long serialVersionUID = 1L; 


private String id; 
private String name; 
private Integer age; 


public Person() { 
super(); 


public Person(String id,String name, Integer age) { 
super(); 
this.id - id; 
this.name - name; 
this.age - age; 





} 
// 省 略 getter、setter 方 法 


代码 解释 
"o 用 时 间 序 列 化 接口 ， 因 为 使 用 Jackson 做 序列 化 需 


一 个 空 构造 。 


(4) 数据 访问 : 


package com.wisely.ch8_6_2.domain; 

import javax.annotation.Resource; 

import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.data.redis.core.RedisTemplate; 
import org.springframework.data.redis.core.StringRedisTemplat 
import org.springframework.data.redis.core.ValueOperations; 
import org.springframework.stereotype.Repository; 

import com.wisely.ch8 6 2.dao.Person; 


QRepository 


public class PersonDao { 


@Autowired 
StringRedisTemplate stringRedisTemplate; //1 


@Resource(name="stringRedisTemplate" ) 
ValueOperations<String,String> valOpsStr; //3 


@Autowired 
RedisTemplate<Object, Object> redisTemplate; //2 


@Resource(name="redisTemplate" ) 
ValueOperations«Object, Object» valOps; //4 


public void stringRedisTemplateDemo(){ //5 
valOpsStr.set("xx", "yy"); 


public void save(Person person)( 
valOps.set(person.getId(),person); //6 


public String getString(){ 
return valOpsStr.get("xx");//7 
} 


public Person getPerson(){ 
return (Person) valOps.get("1");//8 


代码 解释 


(Spring Boot 已 为 我 们 配置 StringRedisTemplate， 在 此 处 可 
以 直接 注入 。 


Spring Boot 已 为 我 们 配置 RedisTemplate， 在 此 处 可 以 直 
接 注 入 。 


G@) 可 以 使 用 @Resource 注 解 指 定 stringRedisTemplate， 可 注 


MEF FAT AB AY fel Ei PEER ET 


由 可 以 使 用 @Resource 注 解 指定 redisTemplate， 可 注入 基于 
对 象 的 简单 属性 操作 方法 ; 





(通过 set 方 法 ， 存 储 字 符 串 类 型 。 

(6) 通 过 set 方 法 ， 存 储 对 象 类 型 。 

通过 get 方 法 ， 获 得 字符 串 。 

(9) 通过 get 方 法 ， 获 得 对 象 。 

(5) 配置 

Spring Boot 为 我 们 目 动 配置 了 RedisTemplate， 而 


RedisTemplate 使 用 的 是 JdkSerializationRedisSerializer， 这 个 对 
我 们 演示 Redis 
JdkSerializationRedisSerializer 使 用 二 级 制 形式 存储 数据 ， 在 此 
我 们 将 自己 配置 RedisTemplate 并 定义 Serializer。 


package com.wisely.ch8 6 2; 


import 


import 
import 
import 
import 
import 
import 
import 


import 
import 
import 





Client 很 不 直观 ， 因 为 


java.net .UnknownHostException; 


org 
org 
org 
org 
org 
org 
org 


com 
com 
com 


.Springframework. 
.Springframework. 
.Springframework. 
.springframework. 
.Springframework. 
.Springframework. 
.Springframework. 


boot.SpringApplication; 
boot.autoconfigure.SpringBootAppli 
context.annotation.Bean; 


data. 
data. 
data. 
data. 


redis.connection.RedisConnect 
redis.core.RedisTemplate; 

redis.serializer.Jackson2Json 
redis.serializer.StringRedisS 


.fasterxml.jackson.annotation.JsonAutoDetect; 
.fasterxml.jackson.annotation.PropertyAccessor; 
.fasterxml.jackson.databind.ObjectMapper; 


QSpringBootApplication 
public class Ch862Application { 


public static void main(String[] args) { 
SpringApplication.run(Ch862Application.class, args); 


@Bean 

@SuppressWarnings({ "rawtypes", "unchecked" }) 

public RedisTemplate<Object, Object» redisTemplate(RedisC 

throws UnknownHostException { 
RedisTemplate<Object, Object» template = new RedisTem 
O; 

template.setConnectionFactory(redisConnectionFactory ) 
Jackson2JsonRedisSerializer jackson2JsonRedisSerializ 
ObjectMapper om = new ObjectMapper(); 
om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect 
om.enableDefaultTyping(ObjectMapper.DefaultTyping.NON 
jackson2JsonRedisSerializer.setObjectMapper(0om); 


template.setValueSerializer(jackson2JsonRedisSerializ 
template.setKeySerializer(new StringRedisSerializer() 


template.afterPropertiesSet(); 
return template; 


代码 解释 
QD 设置 值 (value) 的 序列 化 采用 


Jackson2JsonRedisSerializer。 
(WEE (key) 的 序列 化 采用 StringRedisSerializer。 
(6) 控制 器 : 


package com.wisely.ch8_6_2.web; 


import org.springframework.beans.factory.annotation.Autowired 


import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RestController 


import com.wisely.ch8 6 2.dao.Person; 
import com.wisely.ch8 6 2.domain.PersonDao; 


QRestController 
public class DataController ( 


@Autowired 
PersonDao personDao; 


@RequestMapping("/set") //1 

public void set(){ 
Person person = new Person("1","wyf", 32); 
personDao.save(person); 
personDao.stringRedisTemplateDemo(); 


j 


QRequestMapping("/getStr") //2 
public String getStr(){ 

return personDao.getString(); 
} 


QRequestMapping("/getPerson") //3 
public Person getPerson(){ 

return personDao.getPerson(); 
I 


代码 解释 
演示 设置 字符 及 对 象 。 
QR ANE FAT o 
SEAT R o 


(7) 运行 








演示 设置 字符 及 对 象 ， 访 问 http://localhost: 8080/set, 


此 时 


查看 Redis Client. 


字符 存储 如 图 8-69 所 示 。 





String 





Server localhost 
Key xx 


Value 
图 8-69 字符 存储 


对 象 存储 如 图 8-70 所 示 。 

















Server localhost Database 
Key 











['"com.wisely.ch8_6_2.dao.Person"{"id":"1","name":"wyf","age":32)]] 





图 8-70 ”对象 存储 


演示 获得 字符 ， 访 问 http://localhost: 8080/getStr, 
示 如 图 8-71 所 示 o 


@ localhost:8080/getStr 


€ > Q 0D loess 








yy 





图 8-71 ”获得 字符 


演示 获得 对 象 ， 访 问 http://localhost: 8080/getPerson, 
显示 如 图 8-72 所 示 。 


/ @ localhost8080/getPers- x \ — | 
e> CD localhost:8080/getPerson 


{["id":"1", “name”: “wyf", “age: 32} 





图 8-72 ”获得 对 象 


“9% Spring Boot 企 业 级 开发 


9.1 安全 控制 Spring Security 
9.1.1 Spring Security 快 速 入 门 


1. 什 么 是 Spring Security 


Spring Security 是 专门 针对 基于 Spring 的 项 目的 安全 框架 ， 
充分 利用 了 依赖 注入 和 AOP 来 实现 安全 的 功能 。 


在 早期 的 Spring Security 版本， 使 用 Spring Security 需 要 使 
用 大 量 的 XML 配 置 ， 而 本 市 将 全 部 基于 Java 配 置 来 实现 Spring 
Security 的 功能 。 


安全 框架 有 两 个 重要 的 概念 ， 即 认证 (Authentication〉 和 
授权 (Authorization) 。 认 证 即 确认 用 户 可 以 访问 当前 系统 ;: 
授权 即 确定 用 户 在 当前 系统 下 所 拥有 的 功能 权限 ， 本 市 将 围绕 
认证 和 授权 展开 。 


2.Spring Security 的 配置 





(1) DelegatingFilterProxy 


Spring Security 为 我 们 提供 了 一 个 多 个 过 滤器 来 实现 所 有 安 
全 的 功能 ， 我 们 只 需 注 册 一 个 特殊 的 DelegatingFilterProxy 过 波 
器 到 WebApplicationInitializer 即 可 。 


而 在 实际 使 用 中 ， 我 们 只 需 让 自己 的 Initializer 类 继承 
AbstractSecurity WebApplicationInitializer 抽 象 类 即 可 。 
ee eR E 了 
WebApplicationInitializer 接 口 ， 并 通过 onStartup 方 法 调用 : 


insertSpringSecurityFilterChain(servletContext); 


它 为 我 们 注册 了 DelegatingFilterProxy。 
insertSpringSecurityFilterChain 源 码 如 下 : 


private void insertSpringSecurityFilterChain(ServletConte 
String filterName = DEFAULT_FILTER_NAME; 
DelegatingFilterProxy springSecurityFilterChain = new 
filterName); 
String contextAttribute - getWebApplicationContextAtt 
if (contextAttribute !- null) { 
springSecurityFilterChain.setContextAttribute(con 


registerFilter(servletContext, true, filterName, spri 





所 以 我 们 只 需 用 以 下 代码 即 可 开局 Spring Security wie as 
XH 


public class AppInitializer extends 


j 


(2) 配置 
Spring Security 的 配置 和 Spring MVC 的 配置 类 似 ， 只 需 在 


一 个 配置 类 上 注解 @EnableWebSecurity， 并 让 这 个 类 继承 
WebSecurityConfigurerAdapter 即 可 。 我 们 可 以 通过 重 写 
configure 方 法 来 配置 相关 的 安全 配置 。 


代码 如 下 : 


@Configuration 
QEnablewebSecurity 
public class WebSecurityConfig extends WebSecurityConfigurerA 


QOverride 

protected void configure(HttpSecurity http) throws Except 
super.configure(http); 

I 


QOverride 
protected void configure(AuthenticationManagerBuilder aut 
super.configure(auth); 


QOverride 

public void configure(WebSecurity web) throws Exception { 
super.configure(web); 

} 


3. 用 户 认证 


认证 需要 我 们 有 一 套用 户 数据 的 来 源 ， 而 授权 则 是 对 于 某 
个 用 户 有 相应 的 角色 权限 。 在 Spring Security 里 我 们 通过 重 写 


protected void configure(AuthenticationManagerBuilder auth) 





方法 来 实现 定制 。 


(1) 内 存 中 的 用 户 


使 用 AuthenticationManagerBuilder 的 
inMemoryAuthentication 方 法 即 可 添加 在 内 存 中 的 用 户 ， 并 可 
给 用 户 指定 角色 权限 


@Override 
protected void configure(AuthenticationManagerBuilder aut 
auth. inMemoryAuthentication( ) 
.withUser("wyf").password("wyf").roles("ROLE_ADMI 
.and() 
.WithUser("wisely").password("wisely").roles("ROL 


(2) JDBC 中 的 用 户 
JDBC 中 的 用 户 直接 指定 dataSource 即 可 。 








@Autowired 
DataSource dataSource; 


@Override 
protected void configure(AuthenticationManagerBuilder aut 
auth. jdbcAuthentication().dataSource(dataSource) ; 








不 过 这 看 上 去 很 奇怪 ， 其 实 这 里 的 Spring Security 是 默认 了 
你 的 数据 库 结构 的 。 通过 dbeAutfenicádon 的 源码 ， 我 们 可 以 
看 出 oe 中 定义 了 默认 的 用 户 及 角色 权限 获取 的 
SQL A : 


public static final String DEF USERS BY USERNAME QUERY = "sel 
+ "from users " + "where username = ?"; 
public static final String DEF AUTHORITIES BY USERNAME QU 


+ "from authorities " + "where username = ?"; 











当然 我 们 可 以 自 定 义 我 们 的 查询 用 户 和 权限 的 SQL 语句 ， 
例如 : 


@Override 


protected void configure(AuthenticationManagerBuilder aut 
auth. jdbcAuthentication().dataSource(dataSource) 
.usersByUsernameQuery("select username, password, t 
+ "from myusers where username = ?") 
.authoritiesByUsernameQuery("select username, role 
+ "from roles where username = ?"); 


(3) 通用 的 用 户 


上 面 的 两 种 用 户 和 权限 的 获取 方式 只 限于 内 存 或 者 
JDBC， 我 们 的 数据 访问 方式 可 以 是 多 种 各 样 的 ， 可 以 是 非 关 
系 型 数据 库 ， 也 可 以 是 我 们 常用 的 PA 等 。 





这 时 我 们 需要 自 定 义 实现 UserDetailsService 接 口 。 上 面 的 
内 存 中 用 户 及 JDBC 用 户 就 是 UserDetailsService 的 实现 ， 定 义 
如 下 : 








public class CustomUserService implements UserDetailsService 
@Autowired 


SysUserRepository userRepository; 


QOverride 
public UserDetails loadUserByUsername(String username) th 


SysUser user - userRepository.findByUsername(username 

List«GrantedAuthority» authorities -new ArrayList«Gra 

0; 
authorities.add(new SimpleGrantedAuthority( "ROLE ADMI 
return new User(user.getUsername( ),user.getPassword( ) 


说 明 : SysUser 是 我 们 系统 的 用 户 领 域 对 象 类 ，User 来 自 于 


org.springframework.security.core.userdetails.User. 


除 此 之 外 ， 我 们 还 需要 注册 这 个 CustomUserService， 代 码 
如 下 : 


@Bean 

UserDetailsService customUserService(){ 
return new CustomUserService(); 

} 


@Override 
protected void configure(AuthenticationManagerBuilder aut 
auth.userDetailsService(customUserService()); 


4. 请 求 授 权 


Spring Security 是 通过 重 写 


protected void configure(HttpSecurity http) 


方法 来 实现 请 求 拦截 的 。 
Spring Security 使 用 以 下 匹配 器 来 匹配 请 求 路 径 : 





e antMatchers: 使 用 Ant 风 格 的 路 径 匹 配 。 
e regexMatchers: 使 用 正则 表达 式 匹 配 路 径 。 


anyRequest: 匹配 所 有 请 求 路 径 。 


在 匹配 了 请 求 路 径 后 ， 需 要 针对 当前 用 户 的 信息 对 请 求 路 
径 进 行 安 全 处 理 ，Spring Security 提 供 了 表 9-1 所 示 的 安全 处 理 
AE. 











表 9-1 安全 处 理 方法 














方 法 用 途 
access(String) Spring EL 表达 式 结 果 为 true 时 可 访问 
anonymous() 匿名 可 访问 
denyAll() 用 户 不 能 访问 
fully Authenticated() 用 户 完全 认证 可 访问 CHE remember me 下 自动 登录 ) 





sAnyAuthority(String. ..) 如 果 用 户 有 参数 ， 则 其 中 任 一 权限 可 访问 
sAnyRole(String. 如 果 用 户 有 参数 ， i 角色 可 访问 











asIpAddress(String) AUR PE BIZ 1f TP 则 可 访问 
sRole(String) 








ha 
ha 
hasAuthority(String) 
ha 
ha 
pe 





mitAll() 
emberMe() me 登录 的 用 户 访问 


authenticated() J 登录 后 可 访问 


我 们 可 以 看 一 下 下 和 面 的 示例 代码 : 

















QOverride 

protected void configure(HttpSecurity http) throws Except 
http 
.authorizeRequests() //1 
.antMatchers("/admin/**").hasRole("ROLE ADMIN") //2 
.antMatchers("/user/**").hasAnyRole("ROLE ADMIN", "ROL 
.anyRequest().authenticated();//4 


代码 解释 
(通过 authorizeRequests 方 法 来 开始 请 求 权 限 配 置 。 





QWE KVL Ac/admin/**, 2 AiHAROLE_ADMINAA EWH 
户 可 以 访问 。 


@) 请 求 匹配 /userv**， 拥 有 ROLE _ADMIN 或 ROLE_USER 角 
色 的 用 户 都 可 访问 。 


(其余 所 有 的 请 求 都 需要 认证 后 (登录 后 ) 才 可 访问 。 
5. 定 制 登录 行为 
我 们 也 可 以 通过 重 写 











protected void configure(HttpSecurity http) 


方法 来 定制 我 们 的 登录 行为 。 
下 面 将 重用 的 登录 行为 的 定制 以 简短 的 代码 演示 : 


QOverride 
protected void configure(HttpSecurity http) throws Except 
htt 

.formLogin() //1 

.loginPage("/login") //2 
.defaultSuccessUrl("/index") //3 
.failureUrl("/login?error") //4 
.permitAll() 

.and() 

.rememberMe() //5 
.tokenValiditySeconds(1209600) //6 
.key("myKey") //7 

.and() 

.logout()//8 
.logoutUrl("/custom-logout") //9 
.logoutSuccessUrl("/logout-success") //10 
.permitAll(); 


代码 解释 

(D 通 过 formLogin 方 法 定制 登录 操作 。 

已 使 用 loginPage 方 法 定制 登录 页 面 的 访问 地 址 。 
(3)defaultSuccessUrl1R XE 1 35 |, 1] Ji Ps [8] BI] V4 TT o 
(4)failureUrl 指 定 登 录 失 败 后 转 问 的 页 面 。 
(OrememberMe 开 启 cookie 存 储 用 户 信 息 。 


(@tokenValiditySeconds 指 定 cookie 有 效 期 为 1209600 秒 ， 即 
2 个 星期 。 


(Dkey 指 定 cookie 中 的 私 钥 。 

(B® 使 用 logout 方 法 定制 注销 行为 。 

@)logoutUrl 指 定 注 销 的 URL 路 径 。 
QlogoutSuccessUrl 指 定 注销 成 功 后 转 同 的 页 面 。 








9.1.2 Spring Boot 的 支持 


Spring Boot 针 对 Spring Security 的 自动 配置 在 
org.Springframework.boot.autoconfigure.security 包 中 。 





主要 通过 SecurityAutoConfiguration 和 SecurityProperties 来 完 
成 配置 。 


SecurityAutoConfiguration 导 入 了 
SpringBootWebSecurityConfiguration 中 的 配置 。 在 


SpringBootWebSecurityConfiguration 配 置 中 ， 我 们 获得 如 下 的 
目 动 配置 ; 


D 目 动 配置 了 一 个 内 存 中 的 用 户 ， 
序 局 动 时 出 现 。 


忽略 /css/**、 
xi 4 拦截 。 


3) 自动 配置 的 securityFilterChainRegistration 的 Bean。 


SecurityProperties 使 用 以 “security” 为 前 级 的 属性 配置 Spring 
Security 相 关 的 配置 ， 包 含 : 


账号 为 user， 密 人 码 在 程 


/js/**、/images/** 和 和 /**/favicon.ico 等 静态 





# 内 存 中 的 用 户 默认 账号 为 user 
user.password- # 1 默认 用 户 的 密码 
user.role-USER # 默认 用 户 的 角 
require-ssl-false # 是 否 需 要 ssl 支 持 
enable-csrf=false # 是 否 开 启 “ 跨 站 请 求 伪 造 
basic.enabled=true 
basic.realm=Spring 

basic.path= # /** 
basic.authorize-mode= 

filter-order=0 


security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 


user .name=-user 








rt 
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security. 
security. 
security. 
security. 
security. 
security. 
security. 


Spring _ Boot 为 我 们 做 了 如 此 多 的 配置 ， 
展 的 配置 时 ， 
即 可 ， 无 须 使 用 @EnableWebSecurity 注 解 ， 例 如 : 


headers. 
headers. 
headers. 
headers. 
headers. 


xss=false 
cache=false 
frame-false 
content-type-false 
hsts-all 


sessions-stateless 


ignored- 


# Hp BRP RERE 





当 我 们 需要 目 己 扩 


只 需 配 置 类 继承 WebSecurityConfigurerAdapter 类 


@Configuration 
public class WebSecurityConfig extends WebSecurityConfigurerA 


} 


9.1.3 ”实战 


在 本 节 的 示例 中 ， 我 们 将 演示 使 用 Spring Boot 下 的 Spring 
Security 的 配置 ， 完 成 简单 的 认证 授权 的 功能 。 此 节 我 们 将 通 
过 Spring Data JPA 获 得 用 户 数 据 。 页 面 模板 使 用 Thymeleaf， 
Thymeleaf 也 为 我 们 提供 了 文 持 Spring Security 的 标签 。 


1. 新 建 Spring Boot 项 目 





新 建 Spring Boot 项 目 ， 依 赖 为 JPA (spring-boot-starter-data- 
jpa) ~ Security (spring-boot-starter-security) ~ 
Thymeleaf (spring-boot-starter-thymeleaf) . 


项 目 信 息 : 


groupId: com.wisely 
arctifactId:ch9_1 
package: com.wisely. ch9 1 


并 添加 Oracle 驱 动 及 Thymeleaf 的 Spring Security 的 支持 。 


<dependency> 
<groupId>com.oracle</groupId> 
<artifactId>ojdbc6</artifactId> 
<version>11.2.0.2.0</version> 
</dependency> 


<dependency> 
«groupId»org.thymeleaf.extras«/groupId» 
«artifactId»thymeleaf-extras- 
springsecurity4</artifactId> 
</dependency> 


我 们 的 application.properties 配 置 如 下 : 


spring.datasource.driverClassName-oracle.jdbc.OracleDriver 
spring.datasource.url=jdbc\:oracle\:thin\:@localhost\:1521\:x 
spring.datasource.username=boot 
spring.datasource.password-boot 
logging.level.org.springframework.security- INFO 
spring.thymeleaf.cache-false 


spring.jpa.hibernate.ddl-auto-update 
spring.jpa.show-sql-true 


Yfbootstrap.min.cssJiX & £Esrc/main/resources/static/css F, HE 


路 径 默认 不 拦截 。 
2. 用 户 和 角色 
我 们 使 用 JPA 来 定义 用 户 和 角色 。 
用 户 : 


package com.wisely.ch9_1.domain; 
import java.util.ArrayList; 
import java.util.Collection; 
import java.util.List; 


import javax.persistence.CascadeType; 
import javax.persistence.Entity; 


import javax.persistence.FetchType; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 

import javax.persistence.ManyToMany; 


import org.springframework.security.core.GrantedAuthority; 
import org.springframework.security.core.authority.SimpleGran 
import org.springframework.security.core.userdetails.UserDeta 
QEntity 

public class SysUser implements UserDetails{//1 


private static final long serialVersionUID - 1L; 

QId 

QGeneratedValue 

private Long id; 

private String username; 

private String password; 

@ManyToMany(cascade = {CascadeType.REFRESH}, fetch = Fetch 
private List<SysRole> roles; 


@Override 
public Collection<? extends GrantedAuthority> getAuthorit 
List<GrantedAuthority> auths = new ArrayList<GrantedA 
(); 
List«SysRole» roles-this.getRoles(); 
for(SysRole role:roles)( 
auths.add(new SimpleGrantedAuthority(role.getName 


} 

return auths; 
} 
@Override 


public boolean isAccountNonExpired() { 
return true; 
} 


@Override 

public boolean isAccountNonLocked() { 
return true; 

} 


@Override 
public boolean isCredentialsNonExpired() { 
return true; 


@Override 
public boolean isEnabled() { 
return true, 





} 
// 省 略 getter、setter 方 法 


代码 解释 

让 我 们 的 用 户 实体 实现 UserDetails 接 口 ， 我 们 的 用 户 实 
体 即 为 Spring Security 所 使 用 的 用 户 。 

人 配置 用 户 和 角色 的 多 对 多 关系 。 

@@) 重 写 getAuthorities 方 法 ， 将 用 户 的 角色 作为 权限 。 

角色 : 


package com.wisely.ch9_1.domain; 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity 
public class SysRole { 
QId 


QGeneratedValue 
private Long id; 
private String name; //1 
// 省 略 getter、setter 方 法 





} 
代码 解释 
(Dname 为 角色 名 称 。 


(1) 数据 结构 及 初始 化 
当 我 们 配置 用 户 和 和 角色 的 多 对 多 关系 后 ， 通 过 设置 





spring.jpa.hibernate.ddl-auto-update 


为 我 们 自动 生成 用 户 表 : SYS USER. ffi: 
SYS_ROLE、 关 联 表 : SYS USER ROLES. 


针对 上 面 的 表 结 构 ， 我 们 初始 化 一 些 数据 来 方便 我 们 演 
示 。 在 src/main/resources 下， 新 建 data.sql， 即 新 建 两 个 用 户 ， 
角色 分 别 为 ROLE_ADMIN 和 ROLE_USER， 代 码 如 下 : 


insert 
insert 


insert 
insert 


insert 
insert 


into SYS USER (id,username, password) values (1, 'wyf', 
into SYS_USER (id,username, password) values (2, 'wisel 


into SYS ROLE(id,name) values(1, 'ROLE_ADMIN'); 
into SYS ROLE(id,name) values(2, ROLE USER'); 


into SYS USER ROLES(SYS USER ID,ROLES ID) values(1,1); 
into SYS USER ROLES(SYS USER ID,ROLES ID) values(2,2); 


(2) 传 值 对 象 
用 来 测试 不 同 角色 用 户 的 数据 展示 : 


package com.wisely.ch9_1.domain; 


public 


class Msg { 


private String title; 

private String content; 

private String etraInfo; 

public Msg(String title, String content, String etraInfo) 


} 
// 省 略 getter、setter 方 法 


super(); 

this.title = title; 
this.content = content; 
this.etraInfo = etraInfo; 





3. 数 据 访问 
我 们 这 里 的 数据 访问 很 简单 ， 代 码 如 下 : 





package com.wisely.ch9_1.dao; 
import org.springframework.data.jpa.repository.JpaRepository; 
import com.wisely.ch9 1.domain.SysUser; 


public interface SysUserRepository extends JpaRepository<SysU 


SysUser findByUsername(String username); 


代码 解释 
这 里 只 需 一 个 根据 用 户 名 查 出 用 户 的 方法 。 


4. 目 定义 UserDetailsService 











package com.wisely.ch9_1.security; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.security.core.userdetails.UserDeta 
import org.springframework.security.core.userdetails.UserDeta 
import org.springframework.security.core.userdetails.Username 


import com.wisely.ch9_1.dao.SysUserRepository; 
import com.wisely.ch9 1.domain.SysUser; 


public class CustomUserService implements UserDetailsService 
QAutowired 
SysUserRepository userRepository; 


@Override 
public UserDetails loadUserByUsername(String username) { 


SysUser user = userRepository.findByUsername(username 
if(user == null){ 
throw new UsernameNotFoundException("H P 4 4 f£ 
&"); 
} 


return user; //3 


代码 解释 
OD E E X. 8S SESILUserDetailsServicet [1 . 








OE 5 loadUserByUsername Jy 32: 3k (8 H] P? o 


@B) 我 们 当前 的 用 户 实现 了 UserDetails 接 口 ， 可 直接 返回 给 
Spring Security fii Hj . 


5. BC BE 
(1) Spring MVC 配 置 : 


package com.wisely.ch9_1.config; 


import org.springframework.context.annotation.Configuration; 
import org.springframework.web.servlet.config.annotation.View 
import org.springframework.web.servlet.config.annotation.WebM 


@Configuration 
public class WebMvcConfig extends WebMvcConfigurerAdapter { 


QOverride 

public void addViewControllers(ViewControllerRegistry reg 
registry.addViewController("/login").setViewName("log 

} 


代码 解释 
注册 访问 /login 转 同 login.html 页 面 。 


(2) Spring Security 配 置 : 


package com.wisely.ch9_1.config; 


import 
import 
import 
import 
import 
import 
import 


org. 
org. 
org. 
org. 
org. 
org. 
com. 


springframework 
springframework 
springframework 


.context.annotation.Bean; 
.context.annotation.Configuration; 
.security.config.annotation.authent 
springframework. 
springframework. 
springframework. 


security.config.annotation.web.bui 
security.config.annotation.web.con 
security.core.userdetails.UserDeta 


wisely.ch9_1.security.CustomUserService; 


@Configuration 
public class WebSecurityConfig extends WebSecurityConfigurerA 


@Bean 
UserDetailsService customUserService(){ //2 
return new CustomUserService(); 


d 


QOverride 
protected void configure(AuthenticationManagerBuilder aut 
auth.userDetailsService(customUserService()); //3 


} 


@Override 
protected void configure(HttpSecurity http) throws Except 
http.authorizeRequests( ) 
.anyRequest().authenticated() //4 
.and() 

. formLogin( ) 


. LoginPage("/login" ) 
.failureUrl("/login?error") 
.permitAll() //5 


.and() 
.logout().permitAll(); //6 


代码 解释 


GD 扩展 Spring Security 配 置 需 继承 
WebSecurityConfigurerAdapter. 


IE jt CustomUserServicelf Bean. 
G) 添 加 我 们 目 定 义 的 user detail service iE. 
所 有 请 求 需要 认证 即 登 录 后 才能 访问 。 
(定制 登录 行为 ， 登 录 页 面 可 任意 访问 。 
G) 定 制 注销 行为 ， 注 销 请 求 可 任意 访问 。 
6. 页 面 

(1) 登录 页 面 : 





<!DOCTYPE html» 
«html xmins:th="http://www.thymeleaf.org"> 
<head> 
«meta content="text/html; charset=UTF-8"/> 
<title> 登 录 页 面 </title> 
<link rel="stylesheet" th:href="@{css/bootstap.min.css}"/> 
<style type="text/css"> 
body { 
padding-top: 50px; 


.starter-template { 
padding: 40px 15px; 
text-align: center; 


</style> 
</head> 
<body> 


<nav class="navbar navbar-inverse navbar-fixed-top"> 
«div class="container"> 
«div class="navbar -header"> 


«a Class="navbar-brand" href="#">Spring Security 
示 </a> 
</div> 
<div id="navbar" class="collapse navbar-collapse"> 
«ul class="nav navbar-nav"> 
<li><a th:href="@{/}"> 首页 «/a»«/li» 


</ul> 
«/div»«!--/.nav 


-collapse --> 
«/div» 
«/nav» 
«div class="container"> 


«div class="starter-template"> 
«p th:if="${param.logout}" class="bg-warning"> 已 成 功 
注销 </p><!-- 1 --> 
<p th:if="${param.error}" class="bg-danger"> 有 错误 ， 请 
重 试 </p> <!-- 2 --> 
<h2> 使 用 账号 密码 登录 </h2> 
<form name="form" th:action="@{/login}" action="/ 








2 75 l2 
«div class="form-group"> 
«label for="username"> 账 号 </1Labe1> 
<input type="text" class="form- 
control" name="username" value="" placeholder="Jks" /> 


</div> 
<div class="form-group"> 
«label for="password">2##f5</label> 
<input type="password" class="form- 
control" name="password" placeholder="#f5" /> 
</div> 
<input type="submit" id="login" value="Login" 
primary" /> 
</form> 
</div> 
</div> 
</body> 
</html> 


代码 解释 

(注销 成 功 后 显示 。 

登录 有 错误 时 显示 。 

默认 的 登录 路 径 为 /login。 
(2) 首页 : 


<!DOCTYPE html» 
«html xmlns:thz'http://www.thymeleaf.org" 
xmlns:secz'http://www.thymeleaf.org/thymeleaf-extras- 


springsecurity4"><!-- 1 --> 

<head> 

«meta content="text/html1; charset=UTF-8"/> 

<title sec:authentication="name"></title> <!-- 2 --> 


<link rel="stylesheet" th:href="@{css/bootstrap.min.css}" /> 
<style type="text/css"> 
body { 

padding-top: 50px; 


.starter-template { 
padding: 40px 15px; 
text-align: center; 


} 
</style> 
</head> 
<body> 
<nav class="navbar navbar-inverse navbar-fixed-top"> 
<div class="container"> 
<div class="navbar-header"> 
«a class="navbar-brand" href="#">Spring Security 
示 </a> 
</div> 
<div id="navbar" class="collapse navbar-collapse"> 
<ul class="nav navbar-nav"> 
<li><a th:href="@{/}"> 首页 «/a»«/li» 


</ul> 
«/div»«!--/.nav 


-collapse --> 
</div> 
</nav> 


«div class="container"> 


<div class="starter-template"> 
«hi th:text="${msg.title}"></h1i> 


<p class="bg-primary" th: text="${msg.content}"></p> 


<div sec:authorize="hasRole('ROLE_ADMIN')"> <!-- 3 - 
-> 
<p class="bg-info" th:text="${msg.etraInfo}"> 
</p> 
</div> 


«div sec:authorize="hasRole('ROLE_USER')"> <!-- 4-- 


<p class="bg-info"> 无 更 多 信息 显示 </p> 
</div> 


«form th:action="@{/logout}" method="post"> 
«input type="submit" class="btn btn- 
primary" value=" 注 销 "/><!-- 5 --> 
</form> 
</div> 


</div> 
</body> 
</html> 


代码 解释 
(DThymeleaf 为 我 们 提供 的 Spring Security 的 标签 支持 。 


名 通过 sec: authentication="name" 获 得 当前 用 户 的 用 户 





(sec: authorize="hasRole (ROLE ADMIN') "意味 着 只 
有 当前 用 户 觉得 为 ROLE _ ADMIN 时 ， 才 可 显示 标签 内 内 容 。 


@sec: authorize="hasRole (‘ROLE USER) "意味 着 只 有 
当前 用 户 觉得 为 ROLE_USER 时 ， 才 可 显示 标签 内 内 容 。 


@@) 注 销 的 默认 路 径 为 /logout， 需 通过 POST 请 求 提交 
7.12 till as 
此 控制 器 很 简单 ， 只 为 首页 显示 准备 数据 : 


























package com.wisely.ch9_1.web; 


import org.springframework.stereotype.Controller; 
import org.springframework.ui.Model; 
import org.springframework.web.bind.annotation.RequestMapping 


import com.wisely.ch9_1.domain.Msg; 


@Controller 
public class HomeController { 


QRequestMapping("/") 
public String index(Model model) { 
Msg msg = new Msg(" 测 试 标 题 ", "测试 内 容 ", "额外 信息 ， 只 对 
里 员 显示 ")， 
model.addAttribute("msg", msg); 
return "home"; 


E: 




















VH 





8. 运 行 


(1) 登录 。 访 问 http://localhost: 8080， 将 会 自动 转 到 登 
录 页 面 http:/localhost: 8080/login， 如 图 9-1 所 示 。 
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使 用 账号 密码 登录 
账号 





Login 

















图 9-1 转 到 登录 页 面 http://localhost: 8080/login 


使 用 正确 的 账号 密码 登录 ， 如 图 9-2 所 示 。 
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则 试 内 容 


额外 信息 ， 只 对 管理 员 显 示 


EJ 

















图 9-2 ”使 用 正确 的 账号 密码 登录 
使 用 错误 的 账号 密码 登录 ， 如 图 9-3 所 示 。 
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(2) 注销 。 登 录 成 功 后 ， 单 击 注 铀 按钮 ， 如 图 9-4 所 示 。 
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图 9-4 ” 单 击 注销 按钮 
此 时 页 面 显示 如 图 9-5 所 示 。 
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图 9-5 ” 单 击 注销 按钮 
(2) 用 户 信息 





页 面 上 我 们 将 用 户 名 显示 在 页 面 的 标题 上 ， 如 图 9-6 所 示 。 
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图 9-6 ”用户 信息 
(4) 视图 控制 





wyf 和 wisely 用 户 角色 不 同 ， 因 此 获得 不 同 的 视图 。 
wyf 用 户 视图 如 图 9-7 所 示 。 
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图 9-7 wyf 用 户 视图 
wisely 用 户 视 图 如 图 9-8 所 示 。 
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图 9-8 ”wisely 用 户 视 图 


9.2 Ft XbF Spring Batch 


9.2.1 Spring Batch 快 速 入 门 


1. 什 么 是 Spring Batch 


Spring creat 来 处 理 大 量 数据 操作 的 一 个 框架 ， 主 要 用 
来 读 取 大 量 数据 ， 然 后 进行 一 定 处 理 后 输出 成 指定 的 形式 。 


2.Spring Batch 主 要 组 成 
SpringBatch 主 要 由 以 下 几 部 分 组 成 ， 如 表 9-2 所 示 。 


表 9-2 SpringBatch 组 成 部 分 



































名 称 AO 
JobRepository 用 来 注册 Job 的 容器 
JobLauncher 用 来 启动 Job 的 接口 
Job 我 们 要 实际 执行 的 任务 ， 包 含 一 个 或 多 个 Step 
Step Step- 步 骤 包 含 ItemReader, ItemProcessor 和 ItemWrter 
ItemRead 用 来 读 取 数 TT 的 接口 
ItemPro 用 来 处 理 数据 的 接 ! 
ItemWri 用 来 输出 数据 的 接口 














以 上 Spring Batch 的 主要 组 成 部 分 只 需 注 册 成 Spring 的 Bean 
即 可 。 者 想 开局 批 处 理 的 文 持 还 需 在 配置 类 上 使 用 
(QEnableBatchProcessing. 


个 示意 的 Spring Batch 的 配置 如 下 : 





@Configuration 
@EnableBatchProcessing 
public class BatchConfig { 


@Bean 
public JobRepository jobRepository(DataSource dataSource, 
throws Exception { 

JobRepositoryFactoryBean jobRepositoryFactoryBean = n 
jobRepositoryFactoryBean.setDataSource(dataSource); 
jobRepositoryFactoryBean.setTransactionManager(transa 
jobRepositoryFactoryBean.setDatabaseType("oracle"); 
return jobRepositoryFactoryBean.getObject(); 


j 


QBean 
public SimpleJobLauncher jobLauncher(DataSource dataSourc 
throws Exception { 
SimpleJobLauncher jobLauncher - new SimpleJobLauncher 
jobLauncher.setJobRepository(jobRepository(dataSource 
return jobLauncher; 


j 


QBean 
public Job importJob(JobBuilderFactory jobs, Step s1) ( 
return jobs.get("importJob") 
.incrementer(new RunlIdIncrementer()) 


. flow(s1) 
.end() 
.build(); 
} 
@Bean 


public Step stepi(StepBuilderFactory stepBuilderFactory, 
ItemProcessor<Person,Person> processor) { 
return stepBuilderFactory 
.get("step1") 
.«Person, Person»chunk(65000) 
. reader (reader ) 
. processor (processor) 
.writer(writer ) 
.build(); 
} 


@Bean 

public ItemReader<Person> reader() throws Exception { 
// 新 建 ITtemReader 接 口 的 实现 类 返回 
return reader; 





j 


QBean 
public ItemProcessor<Person, Person» processor() { 
// 新 建 ItemProcessor 接 口 的 实现 类 返回 





return processor, 


j 


QBean 

public Itemwriter«Person» writer(DataSource dataSource) ( 
// 新 建 ITtemwriter 接 口 的 实现 类 返回 
return writer; 





3.Job Is Ur 


知 需 要 监听 我 们 的 Job 的 执行 情况 ， 则 定义 个 一 个 类 实现 
JobExecutionListener， 并 在 定义 Job 的 Bean 上 绑 定 该 监听 器 。 


监听 需 的 定义 如 下 : 


public class MyJobListener implements JobExecutionListener { 


QOverride 

public void beforeJob(JobExecution jobExecution) { 
//Job 开 始 前 

} 


@Override 

public void afterJob(JobExecution jobExecution) { 
//Job 完 成 后 

} 


TEASE SRB E Is Wt ss El Job: 


@Bean 
public Job importJob(JobBuilderFactory jobs, Step s1) { 
return jobs.get("importJob") 


.incrementer(new RunlIdIncrementer()) 


. flow(s1) 
.end() 
.listener(csvJobListener()) 
.build(); 

} 

@Bean 


public MyJobListener myJobListener() { 
return new MyJobListener(); 


4. 数 据 读 取 


Spring Batch 为 我 们 提供 了 大 量 的 ItemReader 的 实现 ， 用 来 
读 取 不 同 的 数据 来 源 ， 如 图 9-9 所 示 。 


5. 数 据 处 理 及 校 验 

数据 处 理 和 校 验 都 要 通过 ItemProcessor 接 口 实现 来 完成 。 
(1) 数据 处 理 

数据 处 理 只 需 实现 ItemProcessor 接 口 ， 重 写 其 process 方 


法 。 方 法 输入 的 参数 是 从 ItemReader 读 取 到 的 数据 ， 返 回 的 数 
据 给 ItemWriter。 














AmapltemReader<T> - org.springframework.batch.item.amqp 
ItemReaderAdapter<T> - org.springframework.batch jsr.item 
ItemReaderAdapter«T» - org.springframework.batch,item.adapter 
IteratoritemReader«T» - org.springframework.batch.item.support 
JmsltemReader«T» - org.springframework.batch.item.jms 
ListitemReader«T» - org.springframework.batch.item.support 
ItemStreamReader«T» - org.springframework.batch.item 
Q^ AbstractitemStreamltemReader<T> - org.springframework.batch.item.support 
4 @* AbstractitemCountingltemStreamltemReader«T» - org.springframework.batch.item.support 
a (* AbstractCursoritemReader«T» - org.springframework.batch.item.database 
© JdbcCursoritemReader«T» - org.springframework.batch.item.database 
© StoredProcedureltemReader«T» - org.springframework.batch.item.database 
4 Q^ AbstractPaginatedDataltemReader<T> - org.springframework.batch.item.data 
© MongoltemReader<T> - org.springframework.batch.item.deta 
©  Neo4jltemReader«T» - org.springframework.batch.item.data 
4 (^ AbstractPagingltemReader<T> - org.springframework.batch.item.database 
© HibernatePagingltemReader«T» - org.springframework.batch.item.database 
© IbatisPagingltemReader«T» - org.springframework.batch.item.database 
© JdbcPagingltemReader«T» - org.springframework.batch.item.database 
© JpaPagingltemReader<T> - org.springframework.batch.item.database 
FlatFileltemReader<T> - org.springframework.batch.item.file 
HibernateCursoritemReader«T» - org.springframework.batch.item.database 
LdifReader - org.springframework.batch.item.ldif 
MappingLdifReader<T> - org.springframework.batch.item.|dif 
RepositoryltemReader<T> - org.springframework.batch.item.data 
StaxEventitemReader<T> - org.springframework.batch.item.xml 
©  MultiRescurceltemReader«T» - org.springframework.batchitem.file 
© ResourcesltemReader - org.springframework.batch.item.file 
© SingleltemPeekableltemReader«T» - org.springframework.batch.item.support 
© SynchronizeditemStreamReader<T> - org.springframework.batch.item.support 
4 @ ResourceAwareltemReaderltemStream<T> - org.springframework.batch.item.file 
©  FlatFileltemReader«T» - org.springframework.batch.item.file 
© LdifReader - org.springframework.batch.item.ldif 
© MappingldifReader<T> - org.springframework.batch.item.|dif 
© StaxEventltemReader«T» - org.springframework.batch.item.xml 
4 Q PeekableltemReader<T> - org.springframework.batch.item 
©  SingleitemPeekableltemReader«T» - org.springframework.batch.item.support 


© 
© 
© 
© 
© 
© 








Press 'Ctri«T' to see the superty 





图 9-9 大量 ItemReader 实 现 


public class MyItemProcessor implements ItemProcessor<Person, 


QOverride 

public Person process(Person person)( 
String name = person.getName().toUpperCase(); 
person.setName(name); 
return person; 


(2) 数据 校 验 


我 们 可 以 JSR-303 (主要 实现 有 hibernate-validator〉 的 注 
解 ， 来 校 验 ItemReader 访 取 到 的 数据 是 否 满 足 要 求 。 


我 们 可 以 让 我 们 的 ItemProcessor 实 现 
ValidatingItemProcessor 接 口 : 





public class MyItemProcessor extends ValidatingItemProcessor 


{ 


@Override 

public Person process(Person item) throws ValidationExcep 
super.process(item); 
return item; 


定义 我 们 的 校 验 器 ， 实 现 的 Validator 接 口 来 自 于 Spring， 
我 们 将 使 用 JSR-303 的 Validator 来 校 验 : 


public class MyBeanValidator<T> implements Validator<T>, Initi 
private javax.validation.Validator validator; 
@Override 
public void afterPropertiesSet() throws Exception { 
ValidatorFactory validatorFactory = Validation.buildD 
validator = validatorFactory.usingContext().getValida 


@Override 

public void validate(T value) throws ValidationException 
Set<ConstraintViolation<T>> constraintViolations = va 
if(constraintViolations.size()>0){ 


StringBuilder message = new StringBuilder (); 

for (ConstraintViolation<T> constraintViolation 
message.append(constraintViolation.getMessage 

} 


throw new ValidationException(message.toString()) 


在 定义 我 们 的 MyItemProcessor 时 必须 将 MyBeanValidator 设 
avez, (SUF: 


@Bean 

public ItemProcessor<Person, Person> processor() { 
MyItemProcessor processor = new MyItemProcessor(); 
processor.setValidator(myBeanValidator()); 
return processor; 


} 
@Bean 


public Validator<Person> myBeanValidator() { 
return new MyBeanValidator<Person>(); 


6. 数 据 输 出 


Spring ”Batch 为 我 们 提供 了 大 量 的 ItemWriter 的 实现 ， 用 来 
将 数据 输出 到 不 同 的 目的 地 ， 如 图 9-11 所 示 。 


7. 计 划 任 务 


Spring ”Batch 的 任务 是 通过 JobLauncher 的 run 方 法 来 执行 
的 ， 因 此 我 们 只 需 在 普通 的 计划 任务 方法 中 执行 JobLauncher 
的 run 方 法 即 可 。 


演示 代码 如 下 ， 别 筷 了 配置 类 使 用 @EnableScheduling 开 局 
计划 任务 支持 : 











@Service 


public class ScheduledTaskService { 
@Autowired 
JobLauncher jobLauncher; 


@Autowired 
Job importJob; 


public JobParameters jobParameters; 
@Scheduled(fixedRate = 5000) 
public void execute() throws Exception { 
jobParameters = new JobParametersBuilder() 
.addLong("time", System.currentTimeMillis()). 
jobLauncher.run(importJob, jobParameters) ; 














= hierarchy of 'org.springframework.batch.item.ItemWriter': Y 





4 ® ItemWriter«T» - org.springframework.batch.item 
[C] AmqpitemWriter«T» - org.springframework.batch.item.amqp 
© ClassifierCompositeltemWriter«T» - org.springframework.batch.item.support 
© HibernateltemWriter<T> - org.springframework.batch.item.database 
© IbatisBatchltemWriter«T» - org.springframework.batch.item.database 
ItemWriterAdapter<T> - org.springframework.batch,jsr.item 





[C] 
© ItemWriterAdapter<T> - org.springframework.batch.item.adapter 
©  JdbcBatchitemWriter«T» - org.springframework.batch.item.database 
© ImsitemWriter<T> - org.springframework.batch.item.jms 
©  JpaltemWriter«T» - org.springframework.batch.item.database 
4 (* KeyValueltemWriter<K, V» - org.springframework.batch.item 
4 © GemfireltemWriter<K, V» - org.springframework.batch.item.data 
© SpELMappingGemfireltemWriter<K, V» - org.springframework.batch.item.data 
il 


© 


ListitemWriter«T» - org.springframework.batch.item.support 
© MimeMessageltemWriter - org.springframework.batch.item.mail,javamail 
© MongoltemWriter<T> - org.springframework.batch.item.data 
©  Neod4jitemWriter«T» - org.springframework.batch.item.data 
©  PropertyExtractingDelegatingltemWriter«T» - org.springframework.batch.item.adapter 
© RepositoryltemWriter<T> - org.springframework.batch.item.data 
© SimpleMailMessageltemWriter - org.springframework.batch.item.mail 
4 Q ItemStreamWriter<T> - org.springframework.batch.item 
4 (Q^ AbstractitemStreamitemWriter«T» - org.springframework.batch.item.support 
©  FlatFileltemWriter«T» - org.springframework.batch.item.file 
©  MultiResourceltemWriter«T» - org.springframework.batch.item-file 
© StaxEventitemWriter«T» - org.springframework.batch.item.xml 
© CompositeltemWriter«T» - org.springframework.batch.item.support 
4 @ ResourceAwareltemWriterltemStream «T» - org.springframework.batch.item.file 
© FlatFileltemWriter«T» - org.springframework.batch.item.file 
© StaxEventitemWriter«T» - org.springframework.batch.item.xml 











Press 'Ctrl«T' to see the supertype hierarch 


图 9-10 ”数据 输出 














8. 参 数 后 置 绑 定 


我 们 在 ItemReader 和 ItemWriter 的 Bean 定 义 的 时 候 ， 参 数 已 
经 便 编 码 在 Bean 的 初始 化 中 ， 代 码 如 下 : 


@Bean 
public ItemReader<Person> reader() throws Exception { 
FlatFileItemReader<Person> reader = new FlatFileItemR 


(); 


reader.setResource(new ClassPathResource("people.csv" 
return reader; 


这 时 我 们 要 读 取 的 文件 的 位 置 已 经 便 编码 在 Bean 的 定义 
中 ， 这 在 很 多 情况 下 不 符合 我 们 的 实际 需求 ， 这 时 我 们 需要 使 
用 参数 后 置 绑 定 。 


要 实现 参数 后 置 绑 定 ， 我 们 可 以 在 JobParameters 中 绑 定 参 
数 ， 在 Bean 定 义 的 时 候 使 用 一 个 特殊 的 Bean 生 命 周 期 注解 
@StepScope， 然 后 通过 @Value 注 入 此 参数 。 


参数 设置 : 














String path = "people.csv"; 
JobParameters jobParameters = new JobParametersBuilder() 
.addLong("time", System.currentTimeMillis()) 


.addString("input.file.name", path) 
.toJobParameters(); 


jobLauncher.run(importJob, jobParameters); 


^E. X Bean: 


QBean 
QStepScope 


public ItemReader<Person> reader (@Value('"# 
{jobParameters['input.file.name']}") String pathToFile) throw 
FlatFileItemReader<Person> reader = new FlatFileItemR 

0; 


reader.setResource(new ClassPathResource(pathToFile)) 
return reader; 


9.2.2 Spring Boot 的 支持 


Spring Boot 对 Spring Batch 文 持 的 源码 位 于 
org.springframework.boot.autoconfigure.batch F . 


Spring Boot 为 我 们 目 动 初始 化 了 Spring Batch 存 储 批 处 理 记 
录 的 数据 库 ， 且 当 我 们 程序 局 动 时 ， 会 目 动 执行 我 们 定义 的 
Job 的 Bean。 


Spring Boot 提 供 如 下 属性 来 定制 Spring Batch: 


spring.batch.job.names-jobi,job2 # 启 动 时 要 执行 的 Job， 默 认 执 行 全 部 
Job 
spring.batch.job.enabled-true # 是 否 自 动 执行 定义 的 Job， 默 认为 是 
spring.batch.initializer.enabled=true # 是 否 初始 化 Spring Batch 
的 数据 库 ， 默 认为 是 

spring.batch.schema= 

spring.batch.table-prefix- # 设置 Spring Batch 的 数据 库 表 的 前 绥 

















9.2.3 ”实战 


本 例 将 使 用 Spring Batch 将 csv 文 件 中 的 数据 使 用 JDBC 批 处 
理 的 方式 插入 数据 库 。 


1.3 Spring Bootlit H 


新 建 Spring ”Boot 项 目 ， 依 赖 为 JDBC (spring-boot-starter- 
jdbc) 、Batch (spring-boot-starter-batch) ~ Web (spring-boot- 
starter-web) . 


项 目 信息 : 


groupId: com.wisely 
arctifactId:ch9_2 
package: com.wisely.ch9_2 


此 项 目 使 用 Oracle 驱 动 ，Spring ”Batch 会 自动 加 载 hsqldb 驱 
所 以 我 们 要 去 除 : 


| 
zy 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
batch</artifactId> 
<exclusions> 
<exclusion> 
«groupId»org.hsqldb 


«/groupId» 
<artifactId>hsqldb</artifactId> 
</exclusion> 
</exclusions> 
</dependency> 


<dependency> 
<groupId>com.oracle</groupId> 
<artifactId>o0jdbc6</artifactId> 
<version>11.2.0.2.0</version> 
</dependency> 


添加 hibernate-validator 依 赖 ， 作 为 数据 校 验 使 用 : 


<dependency> 
<groupId>org.hibernate</groupId> 
<artifactId>hibernate-validator</artifactId> 
</dependency> 


测 斌 csv 数据 ， 位 于 src/main/resources/people.csv 中 ， 内 容 如 


汪 某 某 ,11, 汉族 ,合肥 
张 某 某 , 12, 汉族 , 上 海 

李 某 某 , 13, 非 汉族 ,武汉 
刘 某 , 14, 非 汉 族 , 南京 
欧阳 某 某 ,115, 汉族 ,北京 


数据 表 定 义 ， 位 于 src/main/resources/schema.sql 中 ， 内 容 如 


create table PERSON 
( 


id NUMBER not null primary key, 
name VARCHAR2 (20), 

age NUMBER, 

nation VARCHAR2 (20), 

address VARCHAR2 ( 20) 


); 


数据 源 的 配置 与 前 面 例子 保持 一 致 。 


2. 领 域 模型 类 


package com.wisely.ch9_2.domain; 
import javax.validation.constraints.Size; 
public class Person { 


@Size(max=4,min=2) //1 
private String name; 


private int age; 
private String nation; 


private String address; 





//B getter, setter Ai 


代码 解释 
(D 此 处 使 用 JSR-303 注 解 来 校 验 数据 。 
3. 数 据 处 理 及 校 验 

(1) 处 理 : 


package com.wisely.ch9_2.batch; 


import org.springframework.batch.item.validator.ValidatingIte 
import org.springframework.batch.item.validator.ValidationExc 


import com.wisely.ch9_2.domain.Person; 


public class CsvItemProcessor extends ValidatingItemProcesso 


{ 


QOverride 
public Person process(Person item) throws ValidationExcep 
super.process(item); //1 


if(item.getNation().equals("WWK")){ //2 
item.setNation("01"); 


selse{ 
item.setNation("02"); 
} 


return item; 


代码 解释 
QD 需 执 行 super.proces: (item) 才 会 调用 自 定义 校 验 器 。 


@ 对 数据 做 简单 的 处 理 ， 大 民族 为 汉族 ， 则 数据 转换 成 
其 余 转换 成 02。 


(2) 校 验 : 


01 


-> 


package com.wisely.ch9_2.batch; 
import java.util.Set; 


import javax.validation.ConstraintViolation; 
import javax.validation.Validation; 
import javax.validation.ValidatorFactory; 


import org.springframework.batch.item.validator.ValidationExc 
import org.springframework.batch.item.validator.Validator; 
import org.springframework.beans.factory.InitializingBean; 


public class CsvBeanValidator<T> implements Validator<T>, Init 
private javax.validation.Validator validator; 
QOverride 
public void afterPropertiesSet() throws Exception ( //1 
ValidatorFactory validatorFactory - Validation.buildD 
validator - validatorFactory.usingContext().getValida 


j 


QOverride 
public void validate(T value) throws ValidationException 
Set<ConstraintViolation<T>> constraintViolations = va 


if(constraintViolations.size()>0){ 
StringBuilder message = new StringBuilder (); 
for (ConstraintViolation<T> constraintViolation 
message.append(constraintViolation.getMessage 
} 


throw new ValidationException(message.toString()) 


代码 解释 

使 用 JSR-303 的 Validator 来 校 验 我 们 的 数据 ， 在 此 处 进行 
JSR-303 的 Validator 的 初始 化 。 

使 用 Validator 的 validate 方 法 校 验 数据 。 


4. Job IA Mr 


package com.wisely.ch9_2.batch; 


import org.springframework.batch.core.JobExecution; 
import org.springframework.batch.core.JobExecutionListener; 


public class CsvJobListener implements JobExecutionListener { 


long startTime; 

long endTime; 

QOverride 

public void beforeJob(JobExecution jobExecution) { 
startTime = System.currentTimeMillis(); 
System,out,println(" 任 务 处 理 开 始 " ); 

















j 


QOverride 
public void afterJob(JobExecution jobExecution) ( 
endTime - System.currentTimeMillis(); 




















System.out.println(" 任 务 处理 结 束 " ) ; 


Ha 


时 :" + (endTime - startTime) + "ms"); 


j 


代码 解释 


监听 器 实现 JobExecutionListener 接 口 ， 并 重 写 其 
beforeJob afterJob7; 3X: B] nJ , 


5. 配 置 


配置 的 完成 代码 如 下 : 


package com.wisely.ch9_2.batch; 


import 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


javax.sql.DataSource; 


org. 


org 


org. 
org. 
org. 
org. 
org. 
org. 


org 


org. 
org. 
org. 


org 


org. 
org. 
org. 
org. 
org. 
org. 


org 


org. 


springframework. 
.Springframework. 
springframework. 
springframework. 
springframework. 
springframework. 
springframework. 
springframework. 
.Springframework. 
springframework. 
springframework. 
springframework. 
.springframework. 
springframework. 
springframework. 
springframework. 
springframework. 
springframework. 
springframework. 
.Springframework. 
springframework. 


batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 
batch. 


core. 
,Step ， 
core. 
core. 
core. 
. Launch. support.RunIdInc 
core. 
core. 
core. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 


core 


core 


System.out.println("jÉ 


Job; 


configuration.annotatio 
configuration.annotatio 
configuration.annotatio 


launch.support.SimpleJo 
repository.JobRepositor 
repository.support.JobR 
ItemProcessor; 
ItemReader; 

Itemwriter; 
database.BeanPropertyIt 
database. JdbcBatchItemw 
file.FlatFileItemReader 
file.mapping.BeanWrappe 
file.mapping.DefaultLin 
file.transform.Delimite 
validator.Validator; 


context.annotation.Bean; 
context.annotation.Configuration; 


import org.springframework.core.io.ClassPathResource; 
import org.springframework.transaction.PlatformTransactionMan 


import com.wisely.ch9_2.domain.Person; 


@Configuration 
@EnableBatchProcessing 
public class CsvBatchConfig { 


@Bean 
public ItemReader<Person> reader() throws Exception { 
FlatFileItemReader<Person> reader = new FlatFileItemR 


0; 
reader.setResource(new ClassPathResource("people.csv" 
reader.setLineMapper(new DefaultLineMapper<Person 
C) {t 
setLineTokenizer(new DelimitedLineTokenizer() 
setNames(new String[] { "name","age", "na 
33); 
setFieldSetMapper(new BeanWrapperFieldSetMapp 
() {t 
setTargetType(Person.class); 
33); 
33); 
return reader; 
} 
@Bean 
public ItemProcessor<Person, Person> processor() { 
CsvItemProcessor processor = new CsvlItemProcessor(); 
processor.setValidator(csvBeanValidator()); 
return processor; 
} 
@Bean 
public Itemwriter<Person> writer(DataSource dataSource) { 
JdbcBatchItemwriter<Person> writer = new JdbcBatchIte 
(); 
writer.setItemSqlParameterSourceProvider (new BeanProp 
()); 


String sql = "insert into person " + " 
(id,name,age,nation,address) " 
+ "values(hibernate sequence.nextval, :name, 
writer.setSql(sql); 
writer.setDataSource(dataSource); 
return writer; 


@Bean 
public JobRepository jobRepository(DataSource dataSource, 
throws Exception { 

JobRepositoryFactoryBean jobRepositoryFactoryBean = n 
jobRepositoryFactoryBean.setDataSource(dataSource); 
jobRepositoryFactoryBean.setTransactionManager(transa 
jobRepositoryFactoryBean.setDatabaseType("oracle"); 
return jobRepositoryFactoryBean.getObject(); 


j 


QBean 
public SimpleJobLauncher jobLauncher(DataSource dataSourc 
throws Exception { 
SimpleJobLauncher jobLauncher - new SimpleJobLauncher 
jobLauncher.setJobRepository(jobRepository(dataSource 
return jobLauncher; 


j 


QBean 
public Job importJob(JobBuilderFactory jobs, Step s1) ( 
return jobs.get("importJob") 
.incrementer(new RunlIdIncrementer()) 


. flow(s1) 
.end() 
.listener(csvJobListener()) 
.build(); 

} 

@Bean 


public Step stepi(StepBuilderFactory stepBuilderFactory, 
ItemProcessor<Person,Person> processor) { 
return stepBuilderFactory 
.get("step1") 
.<Person, Person»chunk(65000) 
. reader (reader ) 
. processor (processor) 
.writer(writer ) 
.build(); 


j 


QBean 

public CsvJobListener csvJobListener() ( 
return new CsvJobListener(); 

} 


@Bean 
public Validator<Person> csvBeanValidator() { 
return new CsvBeanValidator<Person>(); 


配置 代码 较 长 ， 我 们 将 拆 开讲 解 ， 首 先 我 们 的 配置 类 要 使 
用 @EnableBatchProcessing 开 局 批 处 理 的 支持 ， 这 点 干 万 不 要 


As. 


ItemReader5E X: 


QBean 
public ItemReader<Person> reader() throws Exception { 
FlatFileltemReader«Person» reader = new FlatFileItemR 
(); //1 
reader.setResource(new ClassPathResource("people.csv" 
reader.setLineMapper(new DefaultLineMapper<Person 


() {{ 773 
setLineTokenizer(new DelimitedLineTokenizer() 
setNames(new String[] { "name","age", "na 
33); 
setFieldSetMapper(new BeanWrapperFieldSetMapp 
O 44 
setTargetType(Person.class); 
33); 
33); 
return reader; 
} 
代码 解释 


QD) 使 用 FlatFileItemReader 读 取 文 件 。 


@) 使 用 FlatFileItemReader 的 setResource 方 法 设置 csv 文 件 的 
路 径 。 


人 在 此 处 对 cvs 文 件 的 数据 和 领域 模型 类 做 对 应 映射 。 





ItemProcessor5E Y : 


QBean 

public ItemProcessor«Person, Person» processor() { 
CsvItemProcessor processor - new CsvItemProcessor(); 
processor.setValidator(csvBeanValidator()); //2 
return processor; 


j 


QBean 
public Validator<Person> csvBeanValidator() { 
return new CsvBeanValidator<Person>(); 
} 


代码 解释 
(9 使 用 我 们 自己 定义 的 ItemProcessor 的 实现 


CsvItemProcessor. 


(2)’Nprocessor4# «E T2 3$ 2$ 7J Csv Bean Validator; 


ItemWriterkxE X: 


QBean 
public Itemwriter«Person» writer(DataSource dataSource) { 
JdbcBatchItemWriter«Person» writer = new JdbcBatchIte 
(); £72 
writer.setlItemSqlParameterSourceProvider(new BeanProp 
0); 
String sql = "insert into person " + " 
(id,name,age,nation,address) " 
* "values(hibernate sequence.nextval, :name, 
writer.setSql(sql); //3 


writer.setDataSource(dataSource); 
return writer; 


代码 解释 


CDSpring 能 让 容器 中 已 有 的 Bean 以 参数 的 形式 注入 ，Spring 
Boot 已 为 我 们 定义 了 dataSource。 


我 们 使 用 JDBC 批 处 理 的 JdbcBatchItemWriter 来 写 数据 到 
数据 库 。 


@ 在 此 设置 要 执行 批 处 理 的 SQL 语句 。 


JobRepository 定 义 : 


@Bean 
public JobRepository jobRepository(DataSource dataSource, 
throws Exception { 

JobRepositoryFactoryBean jobRepositoryFactoryBean = n 
jobRepositoryFactoryBean.setDataSource(dataSource); 
jobRepositoryFactoryBean.setTransactionManager(transa 
jobRepositoryFactoryBean.setDatabaseType("oracle"); 
return jobRepositoryFactoryBean.getObject(); 


代码 解释 


jobRepository 的 定义 需要 dataSource 和 transactioManager， 
Spring Boot 已 为 我 们 自动 配置 了 这 两 个 类 ，Spring 可 通过 方法 
注入 已 有 的 Bean。 


JobLauncher5E Y: 


QBean 
public SimpleJobLauncher jobLauncher(DataSource dataSourc 
throws Exception { 
SimpleJobLauncher jobLauncher - new SimpleJobLauncher 
jobLauncher.setJobRepository(jobRepository(dataSource 
return jobLauncher; 


Job 定 义 : 


@Bean 
public Job importJob(JobBuilderFactory jobs, Step si) { 
return jobs.get("importJob" ) 
.incrementer(new RunIdIncrementer () ) 
.flow(si) //1 


.end() 
.listener(csvJobListener()) //2 
.build(); 

} 

@Bean 


public CsvJobListener csvJobListener() { 
return new CsvJobListener(); 
} 


代码 解释 
(QD 为 Job 指 定 Step。 
DA 5E Is Wr z&csvJobListener. 


Step 定 义 : 


@Bean 
public Step stepi(StepBuilderFactory stepBuilderFactory, 
ItemProcessor<Person,Person> processor) { 
return stepBuilderFactory 
.get("step1") 
.«Person, Person»chunk(65000) //1 
.reader(reader) //2 
.processor(processor) //3 
.writer(writer) //4 
.build(); 


代码 解释 

G 批 处 理 每 次 提交 65000 条 数据 。 
包 给 step 绑 定 reader。 

@) 给 step 绑 定 processor。 

由 给 step 绑 定 writer。 

6. 运 行 


启动 程序 ，Spring Boot 会 自动 初始 化 Spring Batch 数 据 库 ， 
并 将 csv 中 的 数据 导入 到 数据 库 中 。 


为 我 们 初始 化 的 Spring Batch 数 据 库 如 图 9-11 所 示 。 


Hid BATCH JD6_EXECUTION 
! BH BATCH JOB EXECUTION. CONTEXT 
.-EB BATCH JOB EXECUTION, PARAMS 


. FE] BATCH JOB INSTANCE 
EB BATCH srEP ExECUTION 
_ FE BATCH STEP EXECUTION, CONTEXT 





图 9-11 Spring Batch 数 据 库 
监听 器 效果 如 图 9-12 所 示 。 
数据 已 导入 且 做 转换 处 理 ， 如 图 9-13 所 示 。 





任务 处 理 开始 
2015-07-22 21:59:47.424 


任务 处 理 结束 





图 9-12 ”监听 器 效果 
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图 9-13 ”数据 已 导入 且 做 转换 处 理 
将 我 们 在 Person 类 上 定义 的 
@Size (max=4, min=2) 
修改 为 


@Size (max-3, min=2) ， 局 动 程 序 ， 控 制 台 输出 校 验 错 
误 ， 如 图 9-14 所 示 。 


org. springframework.batch.item.validator .ValidationException: 个 数 必须 在 2 和 3 之 间 














eanValidator.java:30 
r.pr 

















图 9-14 ”输入 校 验 错 误 
7. 手 动 触发 任务 
很 多 时 候 批 处 理 任务 是 人 为 触发 的 ， 在 此 我 们 添加 一 个 控 





las, TAWA ATES, FRSA BE Wt 
用 。 


注释 掉 CsvBatchConfig 类 的 @Configuration 注 解 ， 让 此 配置 
类 不 再 起 效 。 新 建 TriggerBatchConfig 配 置 类 ， 内 容 与 
CsvBatchConfig 完 全 保持 一 致 ， 除 了 修改 定义 ItemReader 这 个 
Bean，ItemReader 修 改 后 的 定义 如 下 : 





@Bean 
@StepScope 
public FlatFileItemReader<Person>  reader(QValue("£ 
{jobParameters[ 'input.file.name']}") String pathToFile) throw 
FlatFileItemReader<Person> reader = new FlatFileItemR 


(); 7/1 
reader.setResource(new ClassPathResource(pathToFile) 
reader.setLineMapper(new DefaultLineMapper<Person 
O {{ 7/3 
setLineTokenizer(new DelimitedLineTokenizer() 
setNames(new String[] { "name","age", "na 
33); 
setFieldSetMapper(new BeanWrapperFieldSetMapp 
O tt 
setTargetType(Person.class); 
33); 
33); 
return reader; 
d 


此 处 需 注 意 Bean 的 类 型 修改 为 FlatFileItemReader， 而 不 是 
ItemReader。 因 为 ItemReader 接 口中 没有 read 方 法 ， 若 使 用 
ItemReader 则 会 报 一 个 “Reader must be open before it can be 
read" f£ ix © 


控制 定义 如 下 : 


package com.wisely.ch9_2.web; 


import 
import 
import 
import 
import 
import 
import 


org. 


org 


org. 
org. 
org. 


org 


org. 


. springframework 
springframework 


@RestController 
public class DemoController { 
@Autowired 
JobLauncher jobLauncher; 
@Autowired 


Jo 


public JobParameters 


b importJob; 


springframework. 
.Springframework. 
springframework. 
springframework. 
springframework. 


batch. 
batch. 
batch. 
batch. 
beans. 
.web.bind.annotation.RequestMapping 
.web.bind.annotation.RestController 


@RequestMapping("/imp" ) 
public String imp(String fileName) throws Exception{ 


String path = 
jobParameters 


return "ok"; 


core. Job; 
core.JobParameters; 
core.JobParametersBuilder; 
core.launch.JobLauncher; 
factory.annotation.Autowired 


jobParameters; 


fileName-".csv"; 


new JobParametersBuilder() 
.addLong("time", System.currentTimeMillis 
.addString("input.file.name", path) 
.toJobParameters(); 

jobLauncher.run(importJob, jobParameters); 


此 时 我 们 还 要 关闭 Spring Boot 为 我 们 自动 执行 Job 的 配置 ， 
在 application.properties 里 使 用 下 面 代 码 关 闭 配置 : 





spring.batch.job.enabled-false 


此 时 我 们 


和 


访问 http://localhost: 8080/imp? 


包 eName=people， 可 获得 相同 的 数据 导入 效 末 ， 如 图 9-15 所 


ZW o 
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图 9-15 ”数据 导入 效果 
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在 异步 消息 中 有 两 个 很 重要 的 概念 ， 即 消息 代理 (message 
broker) 和 目的 地 (destination) 。 当 消息 发 送 者 发 送 消息 后 ， 
消息 将 由 消息 代理 接管 ， 消 息 代 理 保 证 消息 传递 到 指定 的 目的 
地 。 


异步 消息 主要 有 两 种 形式 的 目的 地 : 队列 〈queue) 和 主题 
(topic) 。 队 列 用 于 点 对 点 式 (point-to-point) 的 消息 通信 ; 
主题 用 于 发 布 /订阅 式 (publish/subscribe〉 的 消息 通信 。 
































当 消 息 发 送 者 发 送 消息 ， 消 息 代 理 获 得 消息 后 将 消息 放 进 
一 个 队列 (queue) 里 ， 当 有 消息 接收 者 来 接收 消息 的 时 候 ， 
消息 将 从 队列 里 取出 来 传递 给 接收 者 ， 这 时 候 队 列 里 就 没有 了 
这 条 消息 。 

点 对 点 式 确 保 的 是 每 一 条 消息 只 有 唯一 的 发 送 者 和 接收 
者 ， 但 这 并 不 能 说 明 只 有 一 个 接收 者 可 以 从 队列 里 接收 消息 。 
因为 队列 里 有 多 个 消息 ， 点 对 点 式 只 保证 每 一 条 消息 只 有 唯一 
的 发 送 者 和 接收 者 。 

2. 发 布 /订阅 式 

和 点 对 点 式 不 同 ， 发 布 /订阅 式 是 消息 发 送 者 发 送 消息 到 主 





















































题 Ctopic) » MANA RRM IAT EA. HEI TH e 
送 者 和 接收 者 分 别 叫做 发 布 者 和 订阅 者 。 





9.3.1 企业 级 消息 代理 


JMS (Java Message Service) 即 Java 消 息 服务 ， 是 基于 JVM 
消息 代理 的 规范 。 而 ActiveMQ、HornetQ 是 一 个 JMS 消 息 代理 
的 实现 。 


AMQP (Advanced Message Queuing Protocol) 也 是 一 个 消 
明代 理 的 规范 ， 但 它 不 仅 兼容 JMS， 还 支持 跨 语 言 和 平台 。 
AMQP 的 主要 实现 有 RabbitMQ。 


9.3.2 ”Spring 的 支持 


Spring 对 JMS 和 AMQP 的 文 持 分 别 来 自 于 spring-jms 和 
Spring-rabbit. 


它们 分 别 需 要 ConnectionFactory 的 实现 来 连接 消息 代理 ， 
并 分 别提 供 了 JmsTemplate、RabbitTemplate 来 发 送 消息 。 








Spring 为 JMS、AMQP 提 供 了 @JmsListener、 
(QRabbitListenerzX fff (E 77 3; E: s Wr T AS FER ACA B HIE A o RA] 
需要 分 别 通过 @EnableJms、@EnableRabbit 开 启 支 持 。 





9.3.3 Spring Boot 的 支持 





Spring Boot 对 JMS 的 自动 配置 支持 位 于 
org.springframework.boot.autoconfigure.jms 下 ， 支 持 JMS 的 实现 


^H ActiveMQ, HornetQ. Artemis (由 HornetQ 捐 赠 给 ActiveMQ 
的 代码 库 形 成 的 ActiveMQ 的 子 项 目 ) 。 这 里 我 们 以 ActiveMQ 
为 例 ，Spring Boot 为 我 们 定义 了 ActiveMQConnectionFactory 的 
Bean 作 为 连接 ， 并 通过 “spring.activemd” 为 前 绥 的 属性 来 配置 
ActiveMQ 的 连接 属性 ， 包 合 : 

















spring.activemq.broker-url-tcp://localhost:61616 # 消息 代理 的 
路 径 

spring.activemq.user= 

spring.activemq.password- 

spring.activemq.in-memory-true 

spring.activemq.pooled-false 








Spring Boot 在 JmsAutoConfiguration 还 为 我 们 配置 好 了 
JmsTemplate, H 73417 F8 EAH iT Hg scd. BUE 
AFF Ja @EnableJms. 


Spring Boot 对 AMQP 的 目 动 配置 文 持 位 于 
org.springframework.boot.autoconfigure.amqp 下 ， 它 为 我 们 配置 
了 连接 的 ConnectionFactory 和 RabbitTemplate， 且 为 我 们 开启 了 
注解 式 消息 监听 ， 即 自动 开启 @EnableRabbit。RabbitMQ 的 配 
置 可 通过 “spring.rabbitmq” 来 配置 RabbitMQ， 主 要 包含 : 





spring.rabbitmq.host=localhost #rabbitmq 服 务 器 地 址 ， 默 认为 
localhost 

spring.rabbitmq.port-5672 #rabbitmdq 端 口 ， 默 认为 5672 
spring.rabbitmq.username-admin 
spring.rabbitmq.password-secret 





9.3.4 JMS ER 


1.238 ActiveMQ 
(1) 非 Docker 安 装 


读者 可 访问 http://activemq.apache.org/activemq-5111- 
release.html， 下 载 合 适 的 ActiveMQ 版 本 。 


(2) Docker 安 装 


前 面 已 经 下 载 好 了 ActiveMQ 的 镜像 ， 我 们 可 以 通过 下 面 命 
令 运 行 镜像 : 





docker run -d -p 61616: 61616 
p 8161:8161 cloudesire/activemq 


其 中 61616 是 消息 代理 的 端口 ，8161 是 ActiveMQ 的 管理 界 
面 端 口 ， 最 后 别 忘 了 在 VirtualBox 开 启 61616 及 8161 的 端口 映 
射 。 


访问 http://localhost: 8161 可 打开 ActiveMQ 的 管理 界面 ， 管 
理 员 账号 密码 默认 为 admin/admin， 如 图 9-16 所 示 。 


(3) Aik ActiveMQ 


我 们 可 以 将 ActiveMQ 内 骸 在 程序 里 ， 只 要 在 项 目 依赖 里 加 
Aactivemg-broker J FY 。 











<dependency> 
<groupId>org.apache.activemq</groupId> 
<artifactId>activemq-broker</artifactId> 
</dependency> 





=e) 
MI Apache ActiveMQ x Y 


| € C DIS 


cm 
Dm" Apache 
Software Foundation 
a aco Pob d http://www.apache-org/ 


B Useful Links 








Welcome to the Apache ActiveMQ! 


What do you want to do next? 





= Manage ActiveMQ broker 
um See some Web demos (demos not included in default configuration 


Copyright 2005-2013 The Apache Software Foundation. 

















图 9-16 ”ActiveMQ 的 管理 界面 
2. 新 建 Spring Boot 项 目 
新 建 Spring Boot 项 目 ， 依 赖 无 。 


项 | | 信 A : 


groupId: com.wisely 
arctifactId:ch9 3 4 
package: com.wisely.ch9 3 4 


虽然 Spring Boothe SIMS (spring-boot-starter-hornetq ) 
的 依赖 ， 但 默认 我 们 使 用 的 消息 代理 是 HornetQ， 本 例 将 以 
ActiveMQ 为 例 ， 所 以 我 们 需要 添加 spring-jms 和 activemq-client 
的 依 顿 ， 所 需 的 完成 依赖 如 下 : 





<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter</artifactId> 

</dependency> 

<dependency> 
«groupId»org.springframework«/groupId» 


<artifactId>spring-jms</artifactId> 
</dependency> 


<dependency> 
«groupId»org.apache.activemq«/groupId» 


«artifactlId»activemq-client«/artifactId» 
«/dependency» 


配置 ActiveMQ 消 息 代 理 的 地 址 ， 在 application.properties 里 
使 用 : 


spring.activemq.broker-url-tcp://localhost:61616 


TES tao Ps IP EMT) IA BM — CHE 27 2T HE 
Tfj 32€ E340 173 Y iBiz fi] AL, CERTI SS ARC BE — 1 E 
Fr 

3.18 I. XE X. 


定义 JMS 发 送 的 消息 需 实现 MessageCreator 接 口 ， 并 重 写 其 
createMessage 方 法 : 











package com.wisely.ch9_3_4; 

import javax.jms.JMSException; 

import javax.jms.Message; 

import javax.jms.Session; 

import org.springframework.jms.core.MessageCreator; 

public class Msg implements MessageCreator { 
@Override 


public Message createMessage(Session session) throws JMSE 
return session.createTextMessage( "Jill y A"); 
} 


4. 消 息 发 送 及 目的 地 定义 


package com.wisely.ch9 3 4; 


import 
import 
import 
import 
import 


org. 
org. 
org. 
org. 
org. 


springframework.beans.factory.annotation.Autowired 
springframework.boot.CommandLineRunner; 
springframework.boot.SpringApplication; 
springframework.boot.autoconfigure.SpringBootAppli 
springframework.jms.core.JmsTemplate; 


QSpringBootApplication 
public class Ch934Application implements CommandLineRunner{ / 


QAutowired 
JmsTemplate jmsTemplate; //2 


public static void main(String[] args) { 
SpringApplication.run(Ch934Application.class, args); 


} 

@Override 

public void run(String... args) throws Exception { 
jmsTemplate.send("my-destination", new Msg()); //3 

} 


代码 解释 
Spring _ Boot 为 我 们 提供 了 CommandLineRunner 接 口 ， 用 





于 程序 启动 后 执行 的 代码 ， 通 过 重 写 其 run 方 法 执行 。 
CNEA Spring Boot 为 我 们 配置 好 的 JmsTemplate 的 Bean。 


@@ 通 过 JmsTemplate 的 send 方 法 向 my-destination 目 的 地 发 送 
Msg 的 消息 ， 这 里 也 等 于 在 消息 代理 上 定义 了 一 个 目的 地 叫 


my-destination. 


5. 消 息 监 听 





package com.wisely.ch9 3 4; 


import org.springframework.jms.annotation.JmsListener; 
import org.springframework.stereotype.Component; 


@Component 
public class Receiver { 


QJmsListener(destination = "my-destination") 
public void receiveMessage(String message) ( 
System.out.printLn(" 接 受到 : <" + message + ">"); 


代码 解释 


@JmsListener 是 Spring 4.1 为 我 们 提供 的 一 个 新 特性 ， 用 来 
简化 JMS 开 发 。 我 们 只 需 在 这 个 注解 的 属性 destination 指 定 要 
监听 的 目的 地 ， 即 可 接收 该 目的 地 发 送 的 消息 。 此 例 监 听 my- 
destination 目的 地 发 送 的 消息 。 








6. 运 行 


局 动 程序 ， 程 序 会 自动 癌 目 的 地 my-destination 35 7H E, 
而 Receiver 类 注解 了 @JmsLisener 的 方法 会 自动 监听 my- 
destination 发 送 的 消息 。 


控制 侣 显示 Receiver 已 接收 到 消息 ， 如 图 9-17 所 示 。 








2015-87-23 15:55:04.018 
2015-07-23 15:55:04.070 
2015-07-23 15:55:04.979 


2015-07-23 15:55:05.126 


2015-07-23 15:55:05.529 
接收 到 : emp 
图 9-17 ”已 接收 到 消息 


在 ActiveMQ 的 管理 页 面 也 可 以 查看 我 们 目的 地 的 相关 信 
息 ， 如 图 9-18 所 示 。 


Number Of Pending Messages Number Of Consumers Messages Enqueued Messages Dequeued Views Operations 
tive Consu 

















my-destination 0 





9-18 ”查看 目的 地 的 相关 信息 
9.3.5 AMQP ER 


1. 2:3 RabbitMQ 
(1) dEDocker zz 
RabbitMQ 是 基于 erlang 语 言 开 发 的 ， 所 以 安装 RabbitMQ 移 
要 下 载 安 装 erlang， 下 载 地 址 为 
http://www.erlang.org/download.html; 然后 下 载 RabbitMQ， 下 
载 地 址 为 https:/www.rabbitmq.com/download.html。 


(2) Docker 安 装 





前 面 已 经 下 载 好 了 RabbitMQ 的 镜像 ， 以 下 面 命令 运行 一 个 


docker run -d -p 5672:5672 -p 15672:15672 rabbitmq:3- 
management 


其 中 5672 是 消息 代理 的 端口 ，15672 是 Web 管理 界面 的 端 
口 ， 我 们 使 用 的 是 带 管理 界面 的 RabbitMQ; 最 后 还 要 在 
VirtualBox 做 以 下 这 两 个 端口 的 映射 。 


访问 http:Wlocalhost: 15672， 打 开 管 理 界 面 ， 默 认 账 号 密 
码 为 guestguest， 如 图 9-19 所 示 。 

















-es oco ooo = -u | |. | 5 j 
Ma Rabbit Q Manageme 
€ C localhost Y z 
User: guest | 49 out 
a It Cluster: rabbit@7411ccafd3b64 (change) 
RabbitMQ 3.5.3, Erlang 17.5.3 
Connections ^ Channels Exchanges Queues Admin 
Overview 











图 9-19 RabbitMQ 管 理 界面 
2. 新 建 Spring Booth H 


新 建 Spring ” ”Boot 项目， 依赖 为 AMQP Cspring-boot-starter- 
amqp) 。 


项 月 信息 : 


groupId: com.wisely 
arctifactId:ch9 3 5 


package: com.wisely.ch9 3 5 


Spring 


Boot 默 认 我 们 的 Rabbit 主 机 为 localhost、 端 口号 为 
5672， 所 以 我 们 无 须 为 Spring Boot 的 application.properties 配 置 
RabbitMQ 的 连接 信息 。 


3. 发 送信 息 及 目的 地 定义 








package com.wisely.ch9_3_5; 


import 
import 
import 
import 
import 
import 
import 


org. 
org. 


org 


org. 
org. 
org. 
org. 


@SpringBootApplication 
public class Ch935Application implements CommandLineRunner { 
@Autowired 
RabbitTemplate rabbitTemplate; //1 


springframework. 
springframework. 
.Springframework. 
springframework. 
springframework. 
springframework. 
springframework. 


amqp.core.Queue; 
amqp.rabbit.core.RabbitTemplate; 
beans.factory.annotation.Autowired 
boot.CommandLineRunner; 
boot.SpringApplication; 
boot.autoconfigure.SpringBootAppli 
context.annotation.Bean; 


public static void main(String[] args) { 
SpringApplication.run(Ch935Application.class, args); 


QBean //2 
public Queue wiselyQueue(){ 
return new Queue( "my-queue"); 


j 


QOverride 

public void run(String... args) throws Exception ( 

rabbitTemplate.convertAndSend("my-queue", "来 自 

RabbitMQ 的 问候 "); //3 
} 


} 


代码 解释 
Gd 可 注入 Spring Boot 为 我 们 自动 配置 好 的 RabbitTemplate。 
怨 定义 目的 地 即 队 列 ， 队 列 名 称 为 my-queue。 


@@ 通 过 RabbitTemplate 的 convertAndSend 方 法 向 队列 my- 
queue 发 送 消息 。 


4. 消 息 监 听 


package com.wisely.ch9_3_5; 


import org.springframework.amqp.rabbit.annotation.RabbitListe 
import org.springframework.stereotype.Component; 


@Component 
public class Receiver { 


@RabbitListener(queues = "my-queue" ) 


public void receiveMessage(String message) { 
System.out.println("Received <" + message + ">"); 


代码 解释 

使 用 @RabbitListener 来 监听 RabbitMQ 的 目的 地 发 送 的 消 
轧 ， 通 过 queues 属 性 指定 要 监听 的 目的 地 。 

5.3247 

局 动 程序 ， 程 序 会 自动 癌 目 的 地 my-queue 发 送 消息 ， 而 


Recejiver 类 注解 了 @RabbitListener 的 方法 会 自动 监听 my-queue 
发 送 的 消息 。 





控制 台 显 示 如 图 9-20 所 示 。 


2015-07-23 17:14:50.407 INFO 
2015-07-23 17:14:50.807 INFO 
2015-07-23 17:14:50.913 INFO 


2015-07-23 17:14:51.042 INFO 
2015-07-23 17:14:51.119 INFO 


Received «EBjRabbitMQfRja] » 





RabbitMQ 管 


图 9-20 ”控制 台 


理 界 面 显 示 如 图 9-21 所 示 。 











Overview Messages Message rates 


ame Features State Ready Unacked Total incoming deliver / get ack 


D idle 0 0 0 0.00/s 0.00/s ^ 0.00/s 





图 9-21 RabbitMQ 管 理 界面 





9.4 系统 集成 Spring Integration 
9.4.1 Spring Integration 快 速 入 门 


Spring Ingegration 提 供 了 基于 Spring 的 EIP (Enterprise 
Integration Patterns， 企 业 集成 模式 ) 的 实现 。Spring 
Integration 主 要 解决 的 问题 是 不 同系 统 之 间 交 互 的 问题 ， 通 过 
异步 消息 驱动 来 达到 系统 交互 时 系统 之 间 的 松 碍 合 。 本 节 将 基 
于 无 XML 配置 的 原则 使 用 Java 配 置 、 注 解 以 及 Spring 
Integration Java DSL 来 使 用 Spring Integration. 





Spring Integratin 主 要 由 Message、Channel 和 Message 
EndPoint 组 成 。 


9.4.2 Message 


Message 是 用 来 在 不 同 部 分 之 间 传 递 的 数据 。Message 由 两 
部 分 组 成 : 消息 体 Cpayload) 与 消息 头 Cheader) 。 消 息 体 可 
以 是 任何 数据 类 型 (如 XML、JSON，Java 对 象 ) ; 消息 头 表 
示 的 元 数据 瓯 是 解释 消息 体 的 内 容 。 








public interface Message<T> { 
T getPayload(); 
MessageHeaders getHeaders(); 


j 


9.4.3 Channel 














在 消息 系统 中 ， 消 息 发 送 者 发 送 消息 到 通道 (Channel) , 
消息 收受 者 从 通道 CChannel) 接收 消息 。 


1. 顶 级 接口 
(1) MessageChannel 





MessageChannelze Spring Integration 消 息 通 道 的 顶级 接口 : 


public interface MessageChannel { 
public static final long INDEFINITE TIMEOUT = -1; 
boolean send(Message<?> message); 
boolean send(Message<?> message, long timeout); 


j 








当 使 用 send 方 法 发 送 消息 时 ， 返 回 值 为 tue， 则 表示 消息 发 
送 成 功 。MessageChannelj 有 两 大 子 接口 ， 分 别 为 
PollableChannle 〈 可 轮 询 ) 和 Saber oale hannel (可 订阅 〉。 
我 们 所 有 的 消息 通道 类 都 是 实现 这 两 个 接口 。 


(2) PollableChannel 
PollableChannel 有 具备 轮 询 获得 消息 的 能 力 ， 定 义 如 下 : 














public interface PollableChannel extends MessageChannel { 
Message<?> receive(); 
Message<?> receive(long timeout); 


(3) SubscribableChannel 


SubscribableChannel 3€ 1H J. 24 A] f MessageHanlder fy i] 
HJA: 


public interface SubscribableChannel extends MessageChannel { 
boolean subscribe(MessageHandler handler); 
boolean unsubscribe(MessageHandler handler); 








2. 澡 用 消息 通 
(1) PublishSubscribeChannel 
PublishSubscribeChannel 人 允许 广播 消息 给 所 有 订阅 者 ， 配 置 
方式 如 下 : 


@Bean 
public PublishSubscribeChannel publishSubscribeChannel() 


~ 


PublishSubscribeChannel channel = new PublishSubscrib 
return channel; 














其 中 ， 当 前 消息 通道 的 id 为 publishSubscribeChannel。 
(2) QueueChannel 


QueueChannel 人 允许 消息 接收 者 轮 询 获得 信息 ， 用 一 个 队列 
(queue) 接收 消息 ， 队列 的 容量 小 可 配置 ， 配置 方式 如 
i, 








@Bean 
public QueueChannel queueChannel(){ 
QueueChannel channel - new QueueChannel(10); 


return channel; 


其 中 QueueChannel 构 造 参数 10 即 为 队列 的 容量 。 
(3) PriorityChannel 





PriorityChannel 可 按照 优先 级 将 数据 存储 到 对 ， 它 依据 于 消 
斩 的 消息 头 priority 必 性， 配置 方式 如 下 : 





@Bean 
public PriorityChannel priorityChannel(){ 


PriorityChannel channel = new PriorityChannel(10); 
return channel; 


(4) RendezvousChannel 





RendezvousChannel 确 保 每 一 个 接收 者 都 接收 到 消息 后 再 发 
送 消息 ， 配 置 方式 如 下 : 


@Bean 


public RendezvousChannel rendezvousChannel(){ 


RendezvousChannel channel = new RendezvousChannel(); 
return channel; 


(5) DirectChannel 


DirectChannel7 Spring ee 通道 ， 它 允许 


将 消息 发 送 给 为 一 个 订阅 者 ， 然 后 阻碍 发 送 直到 消息 被 接收 ， 
配置 方式 如 下 : 











@Bean 

public DirectChannel directChannel(){ 
DirectChannel channel - new DirectChannel(); 
return channel; 


(6) ExecutorChannel 


ExecutorChannel 5] Zi 4E —^^ 4 2X FEM task executor, ALA 
式 如 下 : 


@Bean 
public ExecutorChannel executorChannel(){ 
ExecutorChannel channel - new ExecutorChannel(executor()) 
return channel; 


j 


QBean 

public Executor executor(){ 

ThreadPoolTaskExecutor taskExecutor = new ThreadPoolTaskE 
taskExecutor.setCorePoolSize(5); 
taskExecutor.setMaxPoolSize(10); 
taskExecutor.setQueueCapacity(25); 
taskExecutor.initialize(); 
return taskExecutor; 





} 
通道 拦截 器 
Spring Integration 给 消息 通道 提供 了 通道 拦截 器 





CChannelInterceptor) ， 用 来 拦截 有 友 送 和 接收 消息 的 操作 。 


ChannelInterceptor 接 口 定义 如 下 ， 我 们 只 需 实现 这 个 接口 
Bl nJ : 





public interface ChannelInterceptor { 
Message<?> preSend(Message<? 
> message, MessageChannel channel); 
void postSend(Message<? 
> message, MessageChannel channel, boolean sent); 
void afterSendCompletion(Message<? 
> message, MessageChannel channel, boolean sent, Exception ex 
boolean preReceive(MessageChannel channel); 


Message<?> postReceive(Message<? 
> message, MessageChannel channel); 
void afterReceiveCompletion(Message<? 


> message, MessageChannel channel, Exception ex); 


我 们 通过 下 面 的 代码 给 所 有 的 channel 增 加 拦截 器 : 


channel.addInterceptor(someInterceptor ); 


9.4.4 Message EndPoint 


消息 端点 mk (Message eae Fe BIEN BA EIN 
M ein 组 件 ， 它 还 可 以 控制 通道 的 路 由 。 我 们 可 用 的 消 
Isti ELS OUP E 


(1) Channel Adapter 


通道 适配器 (Channel Adapter) 是 一 种 连接 外 部 系统 或 传 
输 协 议 的 端点 (EndPoint) ， 可 以 分 为 入 站 Cinbound) 和 出 站 
Coutbound) 。 


通道 适配器 是 单 癌 的 ， 入 站 通道 适配器 只 支持 接收 消息 ， 
出 站 通 LER ANGE. 


一 


Spring Integration 内 置 了 如 下 的 适配器 : 


RabbitMQ. Feed、File、FTP/SFIP、Gemfire、HTTP、 
TCP/UDP. JDBC. JPA. JMS. Mail. MongoDB, Redis, 
RMI. Twitter. XMPP, WebServices (SOAP. REST) 、 
WebSocket= , 


Spring Integration extensions 项 目 提供 了 更 多 的 文 持 ， 地 址 
JJ: https://github.com/spring-projects/spring-integration- 
extensions. 








(2) Gateway 
YELP (Gateway) 类 似 于 Adapter， 但 是 提供 了 双向 的 
请 求 /返回 集成 方式 ， 也 分 为 入 站 Gnbound) 和 出 站 
(outbound) . Spring Integration 对 相应 的 Adapter 多 都 提供 了 
Gateway。 


(3) Service Activator 


Service _ Activator 可 调用 Spring 的 Bean 来 处 理 消息 ， 并 将 处 
理 后 的 结果 输出 到 指定 的 消息 通道 。 


(4) Router 


H (Router) 可 根据 消息 体 类 型 (Payload Type 
Router) 、 消 息 头 的 值 (Header Value Router) 以 及 定义 好 的 
接收 表 (Recipient List Router) 作为 条 件 ， 来 决定 消息 传递 到 
的 通道 。 


(5) Filter 


过 滤器 (Filter) 类 似 于 路 由 (Router) ， 不 同 的 是 过 滤器 
不 决定 消息 路 由 到 哪里 ， 而 是 决定 消息 是 否 可 以 传递 给 消息 通 


























(me 


(6) Splitter 

Harar (Splitter) AYA GR 73) UT BEA) AAA, ROT 
d KP BH E] [ELS — 1 a Be BUA 

(7) Aggregator 


"trus (Aggregator) 与 拆 分 器 相反 ， 它 接收 一 个 
java.util.List 作 为 参数 ， 将 多 个 消息 合并 为 一 个 消息 。 


(8) Enricher 


当 我 们 从 外 部 获得 消息 后 ， 需 要 增加 额外 的 消息 到 已 有 的 
消息 中 ， 这 时 残 需要 使 用 消息 增强 器 〈Enricher) 。 消 恩 增 强 
器 主要 有 消息 体 增强 器 (Payload Enricher) 和 消息 头 增强 器 

(Header Enricher) 两 种 。 

















(9) Transformer 


转换 器 (Transformer) 是 对 获得 的 消息 进行 一 定 的 逻辑 转 
换 处 理 〈 如 数据 格式 转换 ) 。 


(10) Bridge 
使 用 连接 桥 (Bridge) 可 以 简单 地 将 两 个 消息 通道 连接 起 
来 。 








9.4.5 Spring Integration Java DSL 


Spring Itegration 提 供 了 一 个 IntegrationFlow 来 定义 系统 继 
承 流程 ， 而 通过 IntegrationFlows 和 IntegrationFlowBuilder 来 实 








现 使 用 Fluent API 来 定义 流程 。 在 Fluent API 里 ， 分 别提 供 了 下 
面 方法 来 映射 Spring Integration 的 端点 (EndPoint) 。 


transform() -> Transformer 

filter() -> Filter 

handle() -> ServiceActivator. Adapter. Gateway 
split() -> Splitter 

aggregate() -> Aggregator 

route() -> Router 

bridge() -> Bridge 


一 个 简单 的 流程 定义 如 下 : 


@Bean 
public IntegrationFlow demoFlow() { 
return IntegrationFlows.from("input") // 从 
Channel input 获 取消 息 


«String, Integer>transform(Integer::parseInt) // 将 消息 转换 成 整 
数 





.get(); // 获 得 集成 流程 并 注册 为 Bean 


9.4.6 E 


本 章 将 演示 读 取 https://spring.io/blog.atom 的 新 闻 聚 合 文 
件 ，atom 是 一 种 xml 文 件 ， 旦 格式 是 固定 的 ， 示 例如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

«feed xmlnsz"http://www.w3.0rg/2005/Atom"» 
<title>Spring</title> 
<link rel="alternate" href="https://spring.io/blog" /> 
<link rel="self" href="https://spring.io/blog.atom" /> 
<id>http://spring.io/blog.atom</id> 


<icon>https://spring.io/favicon.ico</icon> 
<updated>2015-07-29T14: 46: 00Z</updated> 
<entry> 
<title>Spring Cloud Connectors 1.2.0 released</title> 
«link rel="alternate" href="http://..." /> 
<category term="releases" label="Releases" /> 
<author> 
<name>some author 


</name> 
</author> 
<id>tag:spring.1i0, 2015-07-27:2196</id> 
<updated>2015-07-29T14: 46: 00Z</updated> 
«content type="html">...</content> 
</entry> 
</feed> 





我 们 将 读 取 到 到 消息 通过 分 类 〈Category) ， 将 消息 转 到 
不 同 的 消息 通道 ， 将 分 + 类 为 releases 和 engineering 的 消息 写 入 破 
盘 文件 ， 将 分 类 为 news 的 消息 通过 邮件 发 送 。 


1. 新 建 Spring Boot 项 目 


新 建 Spring Boot 项 目 ， 依 赖 为 Integration Cspring-boot- 
starter-integration) 和 mail (spring-boot-starter-mail) 


项 Hs B: 


groupId: com.wisely 
arctifactlId:ch9 4 
package: com.wisely.ch9 4 


另外 ， 我 们 还 要 添加 Spring ^ Integration*XJ atom maillf] 3c 


B 


<dependency> 
«groupId»org.springframework.integrationc/groupId 
<artifactId>spring-integration- 
feed</artifactId> 
</dependency> 


<dependency> 
«groupId»org.springframework.integrationc/groupId 
<artifactId>spring-integration- 
mail</artifactId> 
</dependency> 


本 例 的 所 有 代码 都 在 入 口 类 中 完成 。 
2. 读 取 流 程 


@Value("https://spring.io/blog.atom") // 1 
Resource resource; 


@Bean(name = PollerMetadata.DEFAULT_POLLER) 

public PollerMetadata poller() { // 2 
return Pollers.fixedRate(500).get(); 

} 


@Bean 

public FeedEntryMessageSource feedMessageSource() throws 
FeedEntryMessageSource messageSource = new FeedEntryM 
return messageSource; 


j 


QBean 
public IntegrationFlow myFlow() throws IOException ( 
return IntegrationFlows.from(feedMessageSource()) //4 
.«SyndEntry, String» route(payload - 
> payload.getCategories().get(0).getName(),//5 
mapping - 
> mapping.channelMapping("releases", "releasesChannel") //6 
.channelMapping("engineering" 
.channelMapping("news", "news 


.get(); // 7 


代码 解释 


(通过 @value 注 解 自 动 获 得 https://spring.io/blog.atom 的 资 
源 o 


(2) FA Fluent API 和 Pollers 配 置 默认 的 轮 询 方式 。 


(S)FeedEntryMessageSource3: by 7jfeed: inbound-channel- 
adapter， 此 处 即 构造 feed 的 入 站 通道 适配器 作为 数据 输入 。 


引流 程 从 from 方 法 开始 。 


名 通过 路 由 方法 route 来 选择 路 由 ， 消 息 体 (payload) 的 类 
型 为 SyndEntry， 作 为 判断 条 件 的 类 型 为 String， 判 断 的 值 是 通 
过 payload 获 得 的 分 类 〈Categroy) ; 


OLAS ARAE E AHN JEDH, EDAN 
releases， 则 转 同 releasesChannel; #4) X engineering, M) 
[HJengineeringChannel; 知 分 类 da IU 4% [h]newsChannel 











@) 通 过 get 方 法 获得 IntegrationFlow 实 体 ， 配 置 为 Spring 的 
Bean 。 


3.releases 流 程 


@Bean 
public IntegrationFlow releasesFlow() { 
return IntegrationFlows.from(MessageChannels.queue("r 
.<SyndEntry, String> transform( 
payload 
> " «" + payload.getTitle() + ") " + payload.getLink() + getF 


.handle(Files.outboundAdapter(new File("e:/ s 
.fileExistsMode(FileExistsMode.APPEND 


.charset("UTF-8") 
.fileNameGenerator(message - 


> "releases.txt") 


.get(); 


.get()) 


代码 解释 
从 消息 通道 releasesChannel 开 始 获取 数据 。 


使 用 transform 方 法 进行 数据 转换 。payload 类 型 为 
SyndEntry， 将 其 转换 为 字符 串 类 型 ， 并 自 定义 数据 的 格式 。 


(引用 handle 方 法 处 理 人 le 的 出 站 适配器 。Files 类 是 由 Spring 
Integration Java DSL 提 供 的 Fluent API 用 来 构造 文件 输出 的 适 配 


LP 


4.engineering 流 程 


@Bean 
public IntegrationFlow engineeringFlow() { 
return IntegrationFlows.from(MessageChannels.queue("e 
.<SyndEntry, String> transform( 
e - 
>" «" + e,getTitle() + ") " + e.getLink() + getProperty("lir 
.handle(Files.outboundAdapter (new File("e:/sp 
.fileExistsMode(FileExistsMode.APPEND 
.charset("UTF-8") 
.fileNameGenerator(message - 


» "engineering.txt") 


.get(); 


.get()) 


代码 解释 
与 releases 流 程 相 同 。 


5.news 流 程 


@Bean 
public IntegrationFlow newsFlow() { 
return IntegrationFlows.from(MessageChannels.queue("n 
.<SyndEntry, String> transform( 
payload - 
> " «" + payload.getTitle() + ") " + payload.getLink() + getF 
.enrichHeaders( //1 
Mail.headers() 
,Subject(" 来 自 Spring 的 新 闻 ") 
.to("wisely-man@126.com" ) 
.from("wisely-manQ126.com")) 
.handle(Mail.outboundAdapter("smtp.126.com") 
.port(25) 
.protocol("smtp") 
.credentials("wisely- 
man@126.com", Poem qma) 
.javaMailProperties(p - 
> p.put("mail.debug", "false")), e -> e.id("smtpOut")) 
.get(); 
} 


代码 解释 
QD 通过 enricherHeader 来 增加 消息 头 的 信息 。 


@) 邮 件 发 送 的 相关 信息 通过 Spring Integration Java DSL 提 
供 的 Mail 的 headers 方 法 来 构造 。 


人 @) 使 用 handle 方 法 来 定义 邮件 发 送 的 出 站 适配器 ， 使 用 
Spring Integration Java DSL 提 供 的 Mail.outboundAdapter 来 构 
造 ， 这 里 使 用 wisely-man@126.com 邮 箱 向 自己 发 送 邮件 。 








6.1847 
(D 写 文件 结果 
AFE: \springblog 目 录 ， 发 现 多 了 两 个 文件 ， 如 图 9-22 所 





7 o 





>| > 计算 机 本 地 磁盘 (E) > springblog | 


SSE) EEV 工具 中 ”帮助 (H) 
包含 到 库 中 v 共享 新 建文 件 去 





ie | | 
面 engineerin releases 
近 访 问 的 位 置 





图 9-22 springblag 目录 


engineering.txt 文 件 内 容 如 图 9-23 所 示 。 


图 EMspringblog\engineering.txt - les 
BAS) RAV tM) Ba BEM =O) 运行 (R) 播 件 (P) BOW 


























s&|4 AA DCA ae Ral 1S BAe LI 

















length:647 lines :7 Ln:1 Col:1 Sel:010 Dos\Windows UTF-8 w/o BOM INS 








[9-23 engineering. txt CF A Z& 


releases.txt 文 件 内 容 如 图 9-24 所 示 。 





[=A S80 BRO HEY SM BRO BEN AO BAR me BOW 7 
ORO + Bid SR 2cle*42/G4/ 518280) 回避 | 国名 

















Jetty etc dy) Spring 4.2) 

(spring Boot 1.2.5 released). hi spring.io/biog/2015/07/02/spring-boot-1-2-S-released 
(Spring Integration 4.2 Milestone 2 is Available (and 4.1.6)]. https://spbring.io/blog/2015/07/07/spring-integration-4-| 
(Spring Boot 1.3.0.M2 Available Now). https://spring.io/blog/2015/07/10/spring-boot-1-3-0-m2-available-now 
(Spring Framework 4.2 RC3 released / GA on July 30) Rhttps://spring.io/blog/2015/07/15/spring-framework-4-2-rc3-releas 
(Spring Reg 2.0.0.Mi zefactors addons, structures for collaboration). httpsi//spring.io/blog/2015/07/20/spring-roo-2-0 = 
(spring Security 4.0.2 Released). https://spring.io/blog/2015/07/23/spring-security-4-0-2-released 
(Spring Security 3.2.8 Released). httos://spring.io/blog/2015/07/23/spring-security-3-2-8-released 
(spring Security Kerberos 1.0.1 Released) https://spring.io/blog/2015/07/24/spring-security-kerberos-1-0-1-released 
(Spring Data Fowler SR2 released) nttps://spring.io/blog/2015/07/28/spring-data-fowler-sr2-released 
(Spring XD 1.2.1 Released) https://spring.io/blog/2015/07/28/spring-xd-1-2-1-released 

Cloud Connectors 1.2.0 released) https://spring.io/blog/2015/07/29/spring-cloud-connectors-1-2-0-released 








m, ] 


length : 1463 lines:13 ln:1 Col:1 Sel:0|0 Dos\Windows UTF-8 w/o BOM 








图 9-24 ”releases.txt 文 件 内 容 
(2) 邮箱 接收 结 


登录 邮箱 可 以 看 到 刚才 发 送 的 邮件 ， 如 图 9-25 所 示 。 


[ «xm || me | s | tom v | 移动 到 v | mnt || ares | 














来 自 Spring 的 新 闻 T 


(=) OF (Webinar Replay: A Spring Showcase: Turkcell's Personal Cloud Storage App) https://spring.io/blog/20 


| = y ost (Webinar Replay: Debug and Maintain your Spring Boot App) https://spring.io/blog/2015/07/09/webinar- 











图 9-25 ”刚才 发 送 的 邮件 


581052 Spring Boot7T Rib MA 


10.1 FERAE 


10.1.1 S ADR 











在 Spring Boot 里 ， 模 板 引 苟 的 页 面 默 认 是 开启 缓存 的 ， 如 
果 修 改 了 页 面 的 内 容 ， 则 刷新 页 面 是 得 不 到 修改 后 的 页 面 的 因 
此 ， 我 们 可 以 在 application.properties 中 关闭 模板 引擎 的 缓存， 
例如 ; 


Thymeleaf 的 配置 : 








spring.thymeleaf.cache-false 


FreeMarker 的 配置 : 


spring.freemarker.cache-false 


Groovy fJ BG Æ: 


spring.groovy.template.cache-false 


Velocity 的 配置 : 


spring.velocity.cache=false 


10.1.2 Spring Loaded 


Spring ^ LoadeduJScHMEPRZSSCTEBJAANU-. P Spring 
Loaded， 地 址 为 : http://repo.spring.io/simple/libs-release- 
local/org/springframework/springloaded/1.2.3.RELEASE/springloa: 
1.2.3.RELEASE.jar， 安 装 单 击 Run Config urations...。 如 图 10-1 
所 示 。 


-0-$---&- 8G 


[3] 1Chi0Application x 





Run As 


Run Configurations... 


Organize Favorites... 








图 10-1 单 击 RunConfigurations 


在 Arguments 标 签 页 的 vm arguments 中 填 入 如 下 内 容 ， 注 意 
下 面 指 定 的 Springloaded 的 路 径 : 


-javaagent:E:\springloaded-1.2.3.RELEASE.jar -noverify 





页 面 截 图 如 图 10-2 所 示 。 


[Ec =s) 




















Create, manage, and run configurations 

Run a Java application Q 

jf X| 83 Name: ChlO0Application 

fype filter text} © Main |09- Arguments BA JRE| 2 Classpath | By Source 8B Environment | ^; 
回 Aspect//Java Appli ^ Program arguments: 

| Eclipse Application 

E3 Eclipse Data Tools 一 
Generic Server 
B. Generic Server(Exte Variables... 
B. HTTP Preview 
B J2EE Preview VM arguments: 
E Java Applet -javaagent:EAspringloaded-1.2.3.RELEASE jar -noverify 

4 [3] Java Application -| ile 

回 Chi0Applicatior _ 
Jv JUnit E Variables... 
| J JUnit Plug-in Test TEENS | 

ma Maven Build ny 
@ OSGi Framework (9; Default: $(workspace loc:ch10) 
@ Pivotal tc Server Other: 
(9 Spring Boot App 
Jy Task Context Test 





X XSL 3 x il 
"m 
Filter matched 21 of 40 items 


| o 
UL 一 




















图 10-2 ”Arguments 标 签 页 
10.1.3 JRebel 


JRebel 是 Java 开 发 热 部 署 的 最 佳 工具 ， 其 对 Spring Boot 也 提 
供 了 极 佳 的 支持 。JRebel 为 收费 软件 ， 可 试用 14 天 。 
(1) 安装 


打开 EclipseMarketPlace， 如 图 10-3 所 示 。 





ver | D © Help Contents 
> Search 
Dynamic Help 
Key Assist... 
Tips and Tricks... 


Æ Report Bug or Enhancement... 
Cheat Sheets... 


*» Check for Updates 
{i Install New Software... 


$ Installation Details 
QJ Eclipse Marketplace... 


€ About Spring Tool Suite 








K|10-3 ”打开 Eclipse Marketplace 
检索 JRebel， 并 安装 ， 如 图 10-4 所 示 。 


Eclipse Marketplace 


Select solutions to install. Press Finish to proceed with installation. 
Press the information button to see a detailed overview and a link to more information. 


Search | Recent | Popular | Installed | |) July Newsletter 
we eee 


JRebel for Eclipse 


JRebel is a productivity tool that allows you to reload changes you make to your 
code without the need to redeploy. It maps your project workspace directly to a... 

















by ZeroTurnaround, Commercial 


[A] Installs: 168K (6,247 last month) | [instan | 





























< Back Install Now > | Finish | 


图 10-4 ”安装 JRebel 
重启 STS， 即 可 完成 安装 。 
(2) 配置 使 用 
注册 试用 ， 如 图 10-5 所 示 。 


© Rett activation Doais E 


Try JRebel for FREE |I already have a license| 














Get started with a free 14-day JRebel Trial. 




















First name it v 
Last name = E v 
Email wisely-man@126.com v 
Phone 15222222222 v 
Company 合肥 v 


[V] I agree with the terms & conditions of the JRebel License Agreement 











| Activate JRebel 











图 10-5 注册 


VERE Spring Boot， 增 加 JRebel 功 能 ， 如 图 10-6 所 示 。 


MS -hin 


New 
Go Into 


Open in New Window 
Open Type Hierarchy 
Show In 


Copy 

Copy Qualified Name 
Paste 

Delete 


Remove from Context 
Build Path 

Source 

Refactor 


Import... 
Export... 


Refresh 

Close Project 

Close Unrelated Projects 
Assign Working Sets... 


Run As 
Debug As 
Profile As 
Validate 


Restore from Local History... 


JRebel 

Maven 

Team 

GitHub 
Compare With 
Configure 
Spring Tools 


Properties 


F4 
Alt+Shift+W > 


Ctrl+C 


Ctrl+V 
Delete 


Ctrl+Alt+Shift+Down 
» 
Alt+Shift+S > 
Alt+Shift+T > 


» | Q Add JRebel Nature 


上 


上 
上 


» 


Alt+Enter 











10-6 ”增加 JRebel 功 能 


此 时 为 我 们 添加 了 一 个 rebel.xml， 用 来 配置 热 部 署 内 容 ， 
如 图 10-7 所 示 。 





> gm src/main/java 

4 (SS src/main/resources 
& static 
(> templates 


/? application.properties 


xX) rebel.xml 


4 (9 src/test/java 

> 8$ com.wisely.ch10 
> mà JRE System Library [JavaSE-1.8] 
> gà Maven Dependencies 

E» src 

(= target 

网 pom.xml 





图 10-7 增加 的 rebcl.xml 


JRebel 会 对 D: /workspace-sts- 
3.7.0.RELEASE/ch10/target/classes 目 录 下 的 文件 进行 热 部 署 ， 
如 图 10-8 所 示 。 


四 rebel.xml $2 





k2xml version-"1.8" encoding="UTF-8"?> 
><application xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" xmlns-"htt, 


<classpath> 
«dir name="D:/workspace-sts-3.7.@.RELEASE/ch1@/target/classes"> 


< ir» 
</classpath> 


</application> 











图 10-8 ”对 文件 进行 热 部 署 
首次 启动 会 询问 是 否 以 JRebael 启 动 程序 ， 如 图 10-9 所 示 。 








©) Launch with JRebel? m | 





You are launching a JRebel-enabled application without the JRebel agent. 
JRebel will not work without it. 











Launch with JRebel agent Not this time 








图 10-9 ”询问 是 否 以 JRebel 启 动 程序 


当 启 动 时 出 现 和 JRebel 相 关 的 信息 ， 表 明 配 置 成 功 ， 如 图 
10-10 所 示 。 





B Rebel: 





be1s-e7-se 

2015-07-30 Rebel: 

2015-07-36 JRebel: 

2015-07-30 JRebel: JRebel Legacy Agent 6.2.2 (201507291221) 
2015-07-30 JRebel: (c) Copyright ZeroTurnaround AS, Estonia, Tartu. 
2015-07-30 Rebel: 

2015-07-30 JRebel: Over the last 1 days JRebel prevented 
2015-07-30 JRebel: at least @ redeploys/restarts saving you about @ hours. 
2015-07-30 JRebel: 

2015-07-36 JRebel: Licensed to iz 

2015-07-30 JRebel: 

2015-07-30 JRebel: License type: evaluation 

2015-07-30 JRebel: Valid from: July 30, 2015 

2015-07-30 JRebel: Valid until: August 13, 2015 

2015-07-30 JRebel: 

2015-07-36 JRebel: You are using an EVALUATION license. 

2015-07-30 JRebel: Days left until license expires: 14 

2015-07-36 JRebel: 

2015-07-30 JRebel: To extend your evaluation or purchase a license, 
2015-07-36 JRebel: contact sales@zeroturnaround.com. 

2015-07-30 JRebel: 


2015-07-36 
2015-07-30 
2015-07-30 
2015-07-30 
2015-07-30 
2015-07-30 
2015-07-30 


JRebel: If you think this is an error, contact support@zeroturnaround.com. 
JRebel: 
JRebel: 
JRebel: 
JRebel: 
JRebel: Directory 'D:\workspace-sts-3.7.0.RELEASE\ch10\target\classes’ will be monitored for changes. 

JRebel: Monitoring resource 'D:\workspace-sts-3.7.0@.RELEASE\ch10\target\classes\application.properties’. 














图 10-10 ”启动 成 功 
10.1.4 spring-boot-devtools 


在 Spring Boot 项 目 中 添加 spring-boot-devtools 依 赖 即 可 实现 
页 面 ， 即 代码 的 热 部 署 。 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-devtools«/artifactId» 
</dependency> 


10.2. XA 
10.2.1 ”jar 形式 


1. 打 包 


若 我 们 在 新 建 Spring Boot 项 目的 时 候 ， 选 择 打 包 方 式 
(Packaging) 是 jar， 则 我 们 只 需 用 : 


mvn pakage 


如 图 10-11 所 示 。 





| m SHEA: C:\Windows\system32\cmd,exe ~_ - E 2E. =o! = 
Microsoft Windows [版 本 6.1.7601] i 
版 权 所 有 (c) 2009 Microsoft Corporation. (EE BLEU. 


C:\Users\wisely>cd D:\workspace-sts-3.7.0.RELEASE\ch10 
C:\Users\wisely>d: 


D: \workspace-sts-3.7.0.RELEASE\ch10>mun package 
[INFO] Scanning for projects... 


--- mauen-resources-plugin:2.6:resources (default-resources) @ ch10 --- 
Using 'UTF-8' encoding to copy filtered resources. 

Copying 1 resource 

Copying 1 resource 





2815-07-30 12:58.166 INFO 7080 - main] 0.5.w.5.handler.SimpleUrlHandlerMap| 
2015-07-30 12:50.195 INFO 7000 main] o.s.W.s, handler. SimpleUrlHandlerMap 
:12:50.362 INFO 7000 main] com.wisely.chi0.Chi0ApplicationTest 
Failures; 6, Errors ipped: ©, Time elapsed: 2.005 sec - in com.wisely.ch 
12:50.377 INFO 7000 Thread-2] o W.C.S.GenericllebüpplicationCont| 


Failures; 0, Errors: 0, Skipped: 0 


--- mauen-jar-plugin r (default-jar) 8 ch10 
[INFO] Building jar:| D:\works sts 6 -RELEASE\ch160\ Earget\chiG-6.6.1-SNAPSHOT. jar 
[INFO] 
[INFO] O.M2:repackage (de 
[INFO] è E 
[INFO] BUILD SUCCESS 
[INF0] - 
[INFO] Total time: 10.898 
[INFO] Finished at: 2015-97-307T23:12:54+08 
[INFO] Final Memory: 29M/216M 
[INEO] Sv is 











» workspace-sts-3.7.0.RELEASE » chiO » target > 





bes 
新 建文 件 夫 


4& classes 

d| generated-sources 

出 generated-test-sources 
Eaa i 

J|. maven-status 

点 surefire-reports 

|. test-classes 

国 ch10-0,0.1-SNAPSHOT 

.. | ch10-0.0,1-SNAPSHOT jer.original 




















图 10-11 运行 mvn pakage 
2.52847 


可 直接 使 用 下 面 命 令 运 行 ， 结 果 如 图 10-12 所 示 。 


java -jar xx.jar 





图 10-12 ”运行 java-jar xx.jaríi ^» 
3. 注 册 为 Linux 的 服务 
pad CURA LT a 这 样 我 们 就 
可 以 通过 命令 开启 、 关 财 以 及 保持 开机 启动 等 功能 。 


藻 想 使 用 此 项 功能 ， 我 们 需 将 代码 中 关于 spring-boot- 
maven-plugin 的 配置 修改 为 : 





<build> 
<plugins> 
<plugin> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-maven- 
plugin</artifactId> 
<configuration> 
<executable>true</executable> 
</configuration> 
</plugin> 
</plugins> 
</build> 


然后 使 用 mvn packages] &.. 
主流 的 Linux 大 多 使 用 init.d 或 systemd 来 注册 服务 。 下 面 以 
CentOS 6.6 演 示 init.d 注 册 服 务 ; 以 CentOS 7.1 演 示 systemd 注 册 
服务 。 操 作 系 统 可 选择 使 用 VirtualBox 安 装 或 者 直接 安装 在 机 
> 
用 SSH 客 户 病 将 jar 包 上 传 到 CentOS 的 /var/apps 下。 
(1) ZCRJDK 














从 Oracle 官 网 下 载 JDK， 注 意 选 择 的 是 : jdk-8u51-linux- 
x64.rpm。 这 是 红 帽 系 Linux 系 统 专用 安装 包 格 式 ， 将 JDK 下 载 
放置 到 Linux 下 任意 目录 。 


执行 下 耐 命令 安装 JDK: 


rpm -ivh jdk-8u51-linux-x64.rpm 


(2) 基于 Linux 的 init.d 部 署 
注册 服务 ， 在 CentOS 6.6 的 终端 执行 : 


Sudo ln - 


S /var/apps/ch10-0.0.1- 
SNAPSHOT.jar /etc/init.d/ch10 


其 中 ch10 就 是 我 们 的 服务 名 。 
启动 服务 : 


service ch10 start 


f. 


停止 服务 : 


service ch10 stop 


服务 状态 : 


service ch10 status 


开机 局 动 : 


chkconfig ch10 on 


项 目 日 志 存 放 于 /var/log/ch10.log 下 ， 可 用 cat 或 tail 等 命令 查 


(3) 基于 Linux 的 Systemd 部 署 
在 /etc/systemd/system/ 目 录 下 新 建文 件 ch10.service， 填 入 下 


面 内 容 : 


[Unit] 
Description=ch10 
After=syslog.target 


[Service] 
ExecStart- /usr/bin/java -jar /var/apps/ch10-0.0.1- 


SNAPSHOT. jar 


[Install] 
WantedBy=multi-user.target 


注意 ， 在 实际 使 用 中 修改 Description 和 ExecStart 后 面 的 内 


局 动 服务 : 


systemctl start ch10 
msystemctl start chi0.service 


停止 服务 : 


systemctl stop ch10 
或 systemct1 stop chi0.service 


服务 状态 : 


systemctl status ch10 
aksystemctl status chi0.service 


开机 局 动 : 


systemctl enable ch10 
aksystemctl enbale chi0.service 


项 目 日 志 : 


journalctl -u ch10 
或 journalct1 -u chi0.service 


10.2.2 war 形式 


1. 打 包 方 式 为 war 时 


新 建 Spring ”Boot 项 目 时 可 选择 打包 方式 (Packaging) 是 
war 形 式 ， 如 图 10-13 所 示 。 








New Spring Starter Project rs 
Name chiO0war 


网 Use default location 


ocatio DAworkspace-sts-3.7.0.RELEASEXch10war Browse 


| 区 fanans 7TH 





Java Version: Language: Java v 
图 10-13 ”选择 打包 方式 为 war 
打包 的 方式 和 jar 包 一 致 ， 执 行 : 


mvn package 


结果 如 图 10-14 所 示 。 











:) » workspace-sts-3.7.0.RELEASE » chl0war » target > vl +> B= target 
助 (H) 
新 建文 件 夫 B= y 
名 称 修改 日 期 关 型 大 小 
Ji ch10war-0.0.1-SNAPSHOT 2015/7/30 星期 .。 SUE 
d classes 2015/7/30 =F... 
J generated-sources 2015/7/30 ERR... 
Ji generated-test-sources 2015/7/30 55... 
J m2e-wtp 2015/7/30 星期 .…. 
Jk maven-archiver 2015/7/30 Es... 
J maven-status 2015/7/30 星期 
J surefire-reports 2015/7/30 BEB... 3 
J test-classes 2015/7/30 BRR... xix 
|_| ch1Owar-0.0.1-SNAPSHOT.war 2015/7/30 星期 ... WAR 文件 14,758 KB 








|_| chi0war-0.0.1-SNAPSHOT.war.original 2015/7/30 B58... ORIGINAL 文件 10,362 KB 








图 10-14 打包 结 
最 后 生成 的 war 文 件 可 以 放 在 你 喜欢 的 Servlet 容 器 上 运行 。 
2. 打 包 方 式 为 jar 时 


若 我 们 新 建 Spring Boot 项 目 时 选择 打包 方式 选择 的 是 jar， 
部 晋 时 我 们 又 想 要 用 war 包 形式 部 署 ， 那 么 怎么 将 jar 形 式 转 换 
成 war 形 式 呢 ?当然 需求 反 过 来 也 是 一 样 的 。 


我 们 比较 下 jar 打 包 和 war 打 包 项 目 文件 的 不 同 之 处 ， 即 可 
知 做 如 下 修改 可 将 jar 打 包 方 式 转换 成 war 打 包 方 式 。 


在 pom.xml 文 件 中 ， 将 








<packaging>jar</packaging> 


修改 为 


<packaging>war</packaging> 


HAD P E RAS 18: SUA AY HR Tomcat ffo: 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
tomcat</artifactId> 
<scope>provided</scope> 
</dependency> 


增加 ServletInitializer 类 ， 内 容 如 下 : 


import org.springframework.boot.builder.SpringApplicationBuil 
import org.springframework.boot.context.web.SpringBootServlet 


public class ServletInitializer extends SpringBootServletInit 


@Override 
protected SpringApplicationBuilder configure(SpringApplic 
return application.sources(Ch10warApplication.class); 


j 


10.3 wHbe—éeE F Docker ty HS 


本 节 我 们 将 在 CentOS 7.1 上 演示 用 Docker 部 署 Spring Boot 
程序 。 前 面 我 们 讲述 了 使 用 已 经 编译 好 的 Docker 镜 像 ， 本 节 我 
们 将 讲述 如 何 编译 自己 的 Docker 镜 像 ， 并 运行 镜像 的 容器 。 


主流 的 云 计 算 (PAAS) 平台 都 支持 发 布 Docker 镜 像 。 
Docker 是 使 用 Dokerfile 文 件 来 编译 自己 的 镜像 的 。 





10.3.1 Dockerfile 


Dockerfile 主 要 有 如 下 的 指令 。 
(1) FROM 指令 


FROM 指 令 指明 了 当前 镜像 继承 的 其 镜像 。 编 译 当 前 镜像 
时 会 目 动 下 载 基 镜像 。 


示例 : 


FROM ubuntu 


(2) MAINTAINER 指 令 
MAINTAINER 指 令 指 明了 当前 镜像 的 作者 。 


示例 : 


MAINTAINER wyf 


(3) RUNES 
RUN 指 令 可 以 在 当前 镜像 上 执行 Linux 命 令 并 形成 一 个 新 
的 层 。RUN 是 编译 时 Cbuild) 的 动作 。 


示例 可 有 如 下 两 种 格式 ，CMD 和 ENTRYPOINT 也 是 如 
此 : 





RUN /bin/bash -c "echo helloworld" 
或 RUN ["/bin/bash", "-c", "echo hello"] 


(4) CMD}: S 

CMD 指 令 指 明了 局 动 镜 像 容 器 时 的 默认 行为 。 一 个 
Dockerfile 里 只 能 有 一 个 CMD 指 令 。CMD 指 令 里 设 定 的 命令 可 
以 在 运行 镜像 时 使 用 参数 覆盖 。CMD 是 运行 时 Crun) 的 动 
作 。 


示例 : 











CMD echo "this is a test" 
可 被 docker run-d image name echo"this is not a test" 7 rii - 
(5) EXPOSE S 


EXPOSE 指 明了 镜像 运行 时 的 容器 必需 监听 指定 的 端口 。 


示例 : 


EXPOSE 8080 


(6) ENV 指 令 
ENV 指 令 可 用 来 设置 环境 变量 。 


示例 : 





ENV myName=wyf 
或 ENV myName wyf 
(7) ADDIE 
ADD 指 令 是 从 当前 工作 目录 复制 文件 到 镜像 目录 中 去 。 


示例 : 








ADD test.txt /mydir/ 


(8) ENTRYPOINT 指 令 





ENTRYPOINT 指 令 可 让 容器 像 一 个 可 执行 程序 一 样 运行 ， 
这 样 镜像 运行 时 可 以 像 软 件 一 样 接收 参数 执行 。 
ENTRYPOINT 是 运行 时 Crun) 的 动作 。 





示例 : 


ENTRYPOINT ["/bin/echo" ] 


我 们 可 以 问 镜 像 传递 参数 运行 : 


docker run -d image_name "this is not a test" 


10.3.2 ”安装 Docker 
通过 下 面 命令 安装 Docker: 


yum install docker 


启动 Docker 并 保持 开机 目 启 : 


systemctl start docker 
systemctl enable docker 


10.3.3 WA ARR x 4r 


我 们 使 用 源码 的 chl0docker 来 作为 演示 用 的 Spring Boot 项 
目 ， 这 个 项 目 很 简单 ， 只 修改 了 入 口 类 ， 代 码 如 下 : 





@SpringBootApplication 
@RestController 


public class Chi0dockerApplication { 
QRequestMapping("/") 
public String home() { 
return "Hello Docker!!"; 
} 


public static void main(String[] args) { 
SpringApplication.run(Chi10dockerApplication.class, ar 


在 CentOS 7.1 上 的 /varvapps/ch10docker 目 录 下 放 入 我 们 编译 
好 的 ch10docker 的 jar 包 ， 如 ch10docker-0.0.1-SNAPSHOT.jar， 
在 同 级 目录 下 新 建 一 个 Dokcerfile 文 件 。 


文件 目录 如 图 10-15 所 示 。 


[rootGMiwiFi-R1D chiOdocker]& cd /var/apps/chiOdocker / 

















hiOdocker-0.0.1-SNAPSHOT.jar  Dockerfile 





图 10-15 “文件 目录 
Dockerfile 文 件 内 容 如 下 : 


FROM java:8 

MAINTAINER wyf 

ADD chi@docker-0.0.1-SNAPSHOT.jar app. jar 
EXPOSE 8080 


ENTRYPOINT ["java","-jar","/app.jar"] 


代码 解释 


刷 基 镜像 为 Java， 标 签 〈 版 本 ) AB. 
作者 为 wyf。 


@ 将 我 们 的 ch10docker-0.0.1-SNAPSHOT.jar 添 加 到 镜像 
中 ， 并 重 命 名 为 app.jar。 


运行 镜像 的 容器 ， 监 昕 8080 端 口 。 


启动 时 运行 java-jar app.jar. 


10.3.4 ”编译 镜像 





在 /var/apps/ch10docker 目 录 下 执行 下 面 命令 ， 执 行 编译 镜 
像 : 


docker build -t wisely/chi0docker . 


其 中 ，wisely/ch10docker 为 镜像 名 称 ， 我 们 设置 wisely 作 为 
前 经， 这 也 是 Docker 镜 像 的 一 种 命名 习惯 。 


注意 ， 最 后 还 有 一 个 “.”， 这 是 用 来 指明 Dockerfile 路 径 
的 ,“.” 表 示 Dockerfile 在 当前 路 径 下 。 


编译 的 过 程 如 图 10-16 所 示 。 














[root@miwiFi-RLD chlOdocker]#|docker build 
Sending build context to Docker daemon 12.98 MB 
sending build context to Docker daemon 

Step 0 : FROM java:8 

Trying to pull repository docker.io/java ... 


49ebfec495el: Pulling image (8) from docker.io/java, endpoint: https://registry- 
49ebfec495el: Download complete 

902b87aaaec9: Download complete 

9a61b6bi315e: Download complete 

iff9f26f09fb: Download complete 

607e965985c1: Download complete 

682b997ad926: Download complete 

a594f78c2a03: Download complete 

8859a87b6160: Download complete 

9dd7ba0ee3fe: Download complete 

93934clae19e: Download complete 

2262501f7b5a: Download complete 

bfb63bOf4dbi: Download complete 

Status: Downloaded newer image for docker.io/java:8 

---» 49ebfec495el 


Step 1 : MAINTAINER at 
---> Running in 7534b74750ae 
---> 38729c353a8a 
Removing intermediate container 7534b74750ae 
Step 2 : ADD chl0docker-0.0.1-SNAPSHOT. jar app. jar 
---» Of51ff5e661d 
Removing intermediate container ci8eedeOb8f8 
Step 3 : EXPOSE 8080 
---» Running in 19bd1a783f27 
---> 7845fe325ed9 
Removing intermediate container 19bd1a783f27 
Step 4 : ENTRYPOINT java -jar /app. jar 
---> Running in d912eci29ac3 
---> 4571ea4b04d3 
Removing intermediate container d912ec129ac3 
Successfully built 4571ea4b04d3 





图 10-16 ”编译 过 程 
这 时 我 们 查看 本 地 镜像 ， 如 图 10-17 所 示 。 


rootGMTWTFT-RID chiOdocker]# docker images 


REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 
wisely/chiOdocker latest 4571ea4b04d3 4 minutes ago 829.3 MB 
docker . io/java 8 49ebfec495e1 2 weeks ago 816.4 MB 





图 10-17 本 地 镜像 


10.3.5 ”运行 


docker run -d --name ch10 -p 8080:8080 wisely/chi0docker 


但 看 我 们 当前 的 容 旧 状态 ， 如 图 10-18 所 示 。 


[rooteMmiwiFi-RiD chlOdocker]& docker ps | 
CONTAINER ID MAGE Ste COMMAND CREATED STATUS PORTS NAMES 
|80138d16d9ef wisely/chiOdocker:latest ^ "java -jar /app.jar" 3 minutes ago Up 3 minutes 0.0.0.0:8080--8080/tcp — ch10 


图 10-18 ”当前 容器 状态 














当前 的 CentOS 系 统 的 记 为 192.168.31.171， 访 问 
http://192.168.31.171: 8008， 我 们 可 以 看 到 如 图 10-19 所 示 页 
IR] 


10.4 Spring Boot 的 测试 


Spring Boot 的 测试 和 Spring MVC 的 测试 类 似 。Spring Boot 
为 我 们 提供 了 一 个 @SpringApplicationConfiguration 来 蔡 代 
@ContextConfiguration， 用 来 配置 Application Context. 


在 Spring ”Boot 中 ， 每 次 新 建 项 目的 时 候 ， 都 会 目 动 加 上 
spring-boot-starter-test 的 依赖 ， 这 样 我 们 就 没有 必要 测试 时 再 
添加 额外 的 jar 包 。 

Spring Boot 还 会 建 一 个 当前 项 目的 测试 类 ， 位 于 
src/test/java 的 根 包 下 。 

本 市 我 们 将 直接 演示 一 个 简单 的 测试 ， 测 试 某 一 个 控制 器 
方法 是 否 满足 测试 用 例 。 





10.4.1 新 建 Spring Boot 项 目 


新 建 Spring Boot 项 目 ， 依 赖 为 JPA Cspring-boot-starter-data- 
jpa) ~ Web (spring-boot-starter-web) 、hsgldb (内 存 数据 
EE) 。 


项 H fe Fi, : 


groupId: com.wisely 
arctifactId:ch10_4 
package: com.wisely.ch10_4 


10.4. ”业务 代码 


实体 类 ; 


package com.wisely.chi0_4.domain; 


import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 


QEntity 

public class Person ( 
QId 
QGeneratedValue 
private Long id; 
private String name; 


public Person() { 
super(); 


public Person(String name) { 
super(); 
this.name = name; 


} 
public Long getId() { 
return id; 


public void setId(Long id) { 
this.id = id; 


j 
public String getName() { 
return name; 


public void setName(String name) { 
this.name - name; 
} 


数据 访问 : 


package com.wisely.chi0_4.dao; 

import org.springframework.data.jpa.repository.JpaRepository; 
import com.wisely.chi10 4.domain.Person; 

public interface PersonRepository extends JpaRepository<Perso 


} 


PEI a: 


package com.wisely.ch10_4.web; 
import java.util.List; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.http.MediaType; 

import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.RestController 


import com.wisely.ch10_4.dao.PersonRepository; 
import com.wisely.chi10 4.domain.Person; 


QRestController 
QRequestMapping("/person") 
public class PersonController { 
QAutowired 
PersonRepository personRepository; 


@RequestMapping(method = RequestMethod.GET,produces = {Me 


public List<Person> findAll()( 
return personRepository.findAll(); 
} 


10.4.3 测试 用 例 


package com.wisely.ch10_4; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


import 
import 
import 
import 


org.junit.Assert; 

org. junit.Before; 

org.junit.Test; 

org.junit.runner.RunWith; 
org.springframework.beans.factory.annotation.Autowired 
org.springframework.boot.test.SpringApplicationConfigu 
org.springframework.http.MediaType; 
org.springframework.test.context.junit4.SpringJUnit4Cl 
org.springframework.test.context.web.WebAppConfigurati 
org.springframework.test.web.servlet.MockMvc; 
org.springframework.test.web.servlet.MvcResult; 
org.springframework.test.web.servlet.request.MockMvcRe 
org.springframework.test.web.servlet.setup.MockMvcBuil 
org.springframework.transaction.annotation.Transaction 
org.springframework.web.context.WebApplicationContext; 


com.fasterxml.jackson.core.JsonProcessingException; 
com.fasterxml.jackson.databind.ObjectMapper; 
com.wisely.chi10 4.dao.PersonRepository; 
com.wisely.chi10 4.domain.Person; 


QRunWith(SpringJUnit4ClassRunner.class) 
@SpringApplicationConfiguration(classes = Ch104Application.cl 
QwebAppConfiguration 

QTransactional //2 


public 


class Chi104ApplicationTests { 


@Autowired 
PersonRepository personRepository; 


MockMvc mvc; 


@Autowired 
WebApplicationContext webApplicationContext; 


String expectedJson; 


@Before //3 
public void setUp() throws JsonProcessingException{ 


Person p1 = new Person("wyf"); 
Person p2 = new Person("wisely"); 
personRepository.save(p1); 
personRepository.save(p2); 


expectedJson -0bj2Json(personRepository.findAll()); / 
mvc = MockMvcBuilders.webAppContextSetup(webApplicati 


j 


protected String Obj2Json(Object obj) throws JsonProcessi 
ObjectMapper mapper - new ObjectMapper(); 
return mapper.writeValueAsString(obj); 


} 


@Test 

public void testPersonController() throws Exception { 
String uri="/person"; 
MvcResult result = mvc.perform(MockMvcRequestBuilders 


int status = result.getResponse().getStatus(); //7 
String content = result.getResponse().getContentAsStr 











Assert.assertEquals(" 错 误 ， 正 确 的 返回 值 为 
200",200, status); / /9 
Assert .assertEquals(" 错 误 ， 返 回 值 和 预期 返回 值 不 一 
致 "，expectedJson, content ); //10 





} 

代码 解释 

使 用 @SpringApplicationConfiguration 蔡 代 
@ContextConfiguration 来 配置 Spring Boot Application 
Context. 


使 用 @Transactional 注 解 ， 确 保 每 次 测试 后 的 数据 将 会 被 
回 滚 。 


(3) 使 用 Junit 的 @Before 注 解 可 在 测试 开始 前 进行 一 些 初始 
化 的 工作 。 


(获得 期 得 返回 的 JSON 字 符 捉 。 
加 将 对 象 转换 成 JSJON 字 符 串 。 


@ 获 得 一 个 request 的 执行 结果 。 
大 


Hl 
CO 获得 request 执 行 结果 的 状态 。 
(8) 获 得 request 执 行 结果 的 内 容 。 
@ 将 预期 状态 200 和 实际 状态 比较 。 
将 预期 字符 串 和 返回 字符 串 比较 。 
10.4.4 执行 测试 


我 们 可 以 使 用 maven 命 令 执行 测试 : 


mvn clean package 


结果 如 图 10-20 所 示 。 





图 10-20 测试 结果 


我 们 还 可 以 在 STS 直 接 使 用 Run As JUnit Test， 效 果 如 图 
10-21 所 示 。 





A Spring Explorer 4 Debug gu JUnit X 四 让 | 多久 画图 了 =- 
Finished after 6.256 seconds 





Runs: /1 — BEmors O — BFalres O EE 


v kí com.wisely.ch10 4.Ch104ApplicationTests | = Failure Trace ER 








E testPersonController (0.404 s) 





图 10-21 直接 使 用 RunAs — Junit Test 
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Spring Boot 提 供 了 运行 时 的 应 用 监控 和 管理 的 功能 。 我 们 
可 以 通过 http、JMX、SSH 协 议 来 进行 操作 。 审 计 、 健 康 及 指 
标 信 息 将 会 自动 得 到 。 


Spring Boot 提 供 了 监控 和 管理 端点 ， 如 表 11-1 所 示 。 


表 11-1 监控 和 管理 端点 














端点 名 描 xk 
actuator 所 有 EndPoint 的 列表 ， 震 加 入 spring HATEOAS 支持 
autoconfig 当前 应 用 的 所 有 自动 配置 
beans 当前 应 用 二 





1 所 有 Bean 的 信息 



































configprops 当前 应 用 中 所 有 

dump 显示 当前 应 用 线程 状 

env 显示 当前 应 用 当前 环境 信 

health 显示 当前 应 用 健康 状况 

info 显示 当前 应 用 信息 

metrics 显示 当前 应 用 的 各 项 指标 信息 

mappings 显示 所 有 的 @RequestMapping 呐 射 的 路 径 
shutdown 关闭 当前 应 用 (默认 关闭 ) 

trace 显示 追踪 信息 CVT http 请求 ) 


11.1 http 


我 们 可 以 通过 http 实 现 对 应 用 的 监控 和 管理 ， 我 们 只 需 在 
pom.xml 中 增加 下 面 依赖 即 可 : 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter- 
actuator</artifactId> 
</dependency> 


既然 通过 http 监 控 和 管理 ， 那 么 我 们 的 项 目 中 必然 需要 
Web 的 依赖 。 本 节 需 新 建 Spring Boot 项 目 ， 依 赖 选择 为 : 
Actuator. Web. HATEOAS. 


11.1.1 新 建 Spring Boot 项 目 


新 建 Spring Boot 项 目 ， 依 赖 为 Actuator (spring-boot-starter- 
actuator) ~ Web (spring-boot-starter-web) 、 
HATEOAS (spring-hateoas) . 


项 目 信息 : 


groupId: com.wisely 
arctifactId:chi1 1 
package: com.wisely. chi1 1 


11.1.2 ”测试 端点 


项 目 建 立 好 之 后 我 们 即 可 测试 各 个 端点 。 
(1) actuator 


访问 http://localhost: 8080/actuator， 效 果 如 图 11-1 所 示 。 





gu 一 o x 
Mi loci «t&oR/actumor x 


€ C fi localhost 


rm fitprop 
beet http // localhost S0SQ/configp 





11-1 访问 actuator 


(2) autoconfig 


访问 http://localhost: 8080/autoconfig， 效 果 如 图 11-2 所 示 。 


E localhost 8080/autocor X 





€ > C fi D localhost:8080/autocontig 


{ 
^positiwMatches { 
"hid tla Configuration. &ÁoditEventRepositorYCenfigursticn" [ 
1 





“condition” — "OnBeanComdst von, 
"message". — “@enditicnal(mMisringBean (types 
org. springt ranework, boot. actuate, audit. AuditEventRepository; SearchStrategy: 212) found no beans” 
} 
1 
7 intAutoConfigurationfwutoCorfigurationReportEndpoint [ 
I 
"oondition". — "OnBeanCondition". 
“message”: "AConditionnlónBemn (types 
org. springframework, boot. sutoconfigure. condition ConditionÉvalustiorReport, SearchStratesy, 211) found the 
following [mutoConfigurationReport] WConditionalOnMirsingBesn (types: 
org. sprang! rame work. boot, actuate, endpoant. Aul cConfigurataunleportEndpoint. SearchStrateyy. current) found 
no boms” 
1 
1 
"Endpo nt AutoConf sguratioriftesRripoint” [ 
1 
“condition”:  "OnBeanCondition', 
"misge. "ülonditionalOnarsangBean (types. org. zpringíramework. boot. actuate. endpoint. Beanz&ndpount 
SearehStrategy sll) found no beans” 
1 
1 
"Engan AutoCon! agur at erffoord agurabionPropertiezReporlEmdpount Í 
1 





图 11-2 访问 autoconfig 
(3) beans 
访问 http://localhost: 8080beans， 效 果 如 图 11-3 所 示 。 


@ localhost 8080/beans x 


€ > C fi D localhost:6080/beans 








“bean”: — "demo&pplication", 

“scope”. "zumpleton'. 

“type”: "com. wisely. ch12, 1. DennApp liest ond$Enhaneer PySprinq oL 18330 4383765" , 
“resource”: “null”, 

"dependencies". O 


"bem. "org.springfrmmework.boot. mitocord igure. PropertyPlaceholderAuroConfiguration", 

“scope”: “singleton”. 

“type”. “ore. sprangt ranevork. boot, autoconf igure, Proper UyPLaceholderAutoConfa curata on Enhancer BySprigGL 
TRS$! 93433", 

“resource”: “null”, 

“dependencies” N 


“org. sprángf ranework. boot. mitoconf igure. condition DeanTypeResistry”. 





11-3 访问 beans 


(4) dump 


访问 http://localhost: 8080/dump， 效 果 如 图 11-4 所 示 。 












zm - o x 
@ localhost:8080/dump x 
\ C fi |D localhost:8080/dump 5| 三 
{ Parsed 
content’ [ 
I 
“threadNane”, — "http-nio-80B0-exec-3", 
^thread]d' 23. 


“fileName”: mul 


*nethodName” “dumpAll Threads” , 
“fileName”: mull, 

"lineNumber": -1, 

"className": "sun management. ThreadInpl", 
"nativellethod' false 





Kl11-4 访问 beans 
(5) configprops 


访问 http://localhost: 8080/configprops, JUR 4011-5) 
小 o 


(6) health 
访问 http://localhost: 8080/health， 效 果 如 图 11-6 所 示 。 
(7) info 


访问 http://localhost: 8080/info， 效 果 如 图 11-7 所 示 。 





/ @localhost:8080/configp: x \ 











€ > C fi |D localhost:8080/configprops ws 
1 四 
BE [Raw | Passi ] i 

{ 


"rel': “self”, 
“href”: “http://localhost: 8080/configprops” 
} 
1 
"management.health. status.CONFIGURATION PROPERTIES': { 
"prefix": “management. health. status”, 
"properties" { 
"order": mull 
} 
Lh 
"metricsEndpoint". { 
"prefix". "endpoints.metrics", 
"properties". { 
"id'; “metrics”, 
"sensitive": true, 
“enabled”: true 
H 
b 
"endpoints. cors.CONFIGURATION PROPERTIES': { 
"prefix": "endpoints. cors”, 
"properties". | 
^allowedorigins: D, 
"maxhge": 1800, 
“exposedHeaders”: D, 
"allowedHeaders": D, 
^allowedMethods":  [] 





图 11-5 访问 ConfigProps 


TEA 








€ > C fi |D localhost:8080/health 


{ 
"status": “UP”, | 
"diskSpace": 
"status". “UP”, 
"total': 118958563328, 
"free": 76100861952, 
“threshold”: 10485760 








k 
”links”: [ 
{ 
“rel”: "self", 
“href”: “http://localhost: 8080/health" 





图 11-6 访问 health 


E 


@ localhost:8080/info x 


€ QC fi (localhost8080/info 


“rel”: “self”, 
“href”: “http: // localhost: 8080/info" 





图 11-7 访问 info 
(8) metrics 


访问 http://localhost: 8080/metrics， 效 果 如 图 11-8 所 示 。 


@ localhost:8080/metrics x 
e Q fi /localhost:8080/metrics 


{ 
“links”: [ 
{ 
"rel'. "sif", 
“href”; “http://localhost: 8080/metrics" 


Parsed 


} 
1, 
“men”: 173568, 
"mem free”: 61266, 
“processors”: 4, 
"instance.uptime': 262047, 
"uptime": 265121, 
“systemload. average”: -1. 
“heap. committed”: 173568, 
"heap. init”: 129024, 
"heap.used': 112301, 
“heap”: 1835008, 
"threads. peak”: 18, 
“threads. daemon”: 16, 
“threads”: 18, 
“classes”: 5928, 
“classes. loaded”: 5928, 
“classes. mloaded”: 0 
“gc.ps_scavenge. count” 
“gc. ps_scavenge. time” 
^gc.ps marksweep. count" 
"gc.ps marksweep. time" 





图 11-8 访问 metrics 
(9) mappings 
访问 http://localhost: 8080/mappings， 效 果 如 图 11-9 所 示 。 





@ localhost:8080/mappin: x 
€ Q fi |D localhost:8080/mappings 


“rel”; "self", 
"href": “http: //localhost: 8080/mappings” 


l, 
"/webjars/**": { 

“bean” "rescurceHandl erMapping" 
E. 
“fee: A 

"bean" "resourceHandl erllapping" 
kh 
"f**/favicon ico": { 

"bean" "f£aviconHandlerMappinz" 
Lh 
"IU/error]": t 


"bean"; “requestMappingHandlerMapping”, 

“method”: “public org. springframework. http. ResponseEnt ity< java. util. Map< java. lang. String. 
java. lang.Object> 

org. springf ramework. boot. autoconf igure. web. BasicErrorCont roller. error (javax. s 
Request)” 


{L/error], pro oduces= [text/html]}*: 1 
"bea requestMappingHandlerMapping”, 
“method” "public org. springframework. web. servlet. Mode lAndView 


org. spr ingf ramework. boot. autoconf igure. web. BasicErrorController. errorHtml (javax. servlet. http. HttpSer * 
m ———— 








11-9 访问 mappings 
(10) shutdown 


shutdown 疹 点 默认 是 关闭 的 ， 我 们 可 以 在 
application.properties 中 开启 : 


endpoints.shutdown.enabled-true 





shutdown ij AN Se RRGET4EAS, FSD BREEN 


ervlet. http. HttpServlet 





Tae Ej 


地 址 ， 所 以 我 们 使 用 PostMan 来 测试 。 用 POST 方式 访问 


http://localhost: 8080/shutdown， 效 果 如 图 11-10 所 示 。 


控制 台 效 果 如 图 11-11 所 示 。 


Builder 


http://localhost-8080/shut No environi 


http;//localhost:8080/shutdown Params 


Authorization Headers (0) d Pre-request script 


No Auth 


Status 2000K Time 333ms 


rel": "self", 
"href": "http://localhost:8080/shutdown 


} 





pesos : “Shutting down, bye 











11-10 访问 shutdown 





2015-08-24 11:21:16.339 INFO 2852 --- [ Thread-3] o.s.c.support.DefaultLifecycleProcessor : Stopping beans in phase 9 
2015-08-24 11:21:16.343 INFO 2852 --- [ Thread-3] o.s.j.e.a.AnnotationMBeanExporter :[Unregistering JMX-exposed beans on shutdown 


图 11-11 控制 人 台 效 果 























(11) trace 


访问 http://localhost: 8080/trace， 效 果 如 图 11-12 所 示 。 


@ localhost:8080/trace 
€ CŒ fi D localhost:8080/trace 


Parsed 


“timestamp”: 1440123604068, 
"info". [f 


"localhost:8080", 
im”: “keep-alive”, 
cept”: “text/html, application/xhtml+xml, application/xml ;q=0. 9, image/webp, */*; gL 


"upgrade-insecure-requests”: "l^, 
“user-agent”: “Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537. 36 (KHTML, 
Gecko) Chrome/44. 0, 2403. 125 Safari/537. 36”, 
": "gzip, deflate, sdch”, 
"zh-CN, zh:q=0. 8, en; 0. 6, zh-TW; FFD. 4, it ;q=0. 2" 


“X- Applicat ior-Co: text” “application”, 
"Content-Type". “application/ json; charset=UTF-8”, 
“Tr mister Encoding’: “chunked”, 

“Date “Fri, 21 Aug 2015 02:20:04 GMT”, 

"status": "200" 








[11-12 访问 trace 


11.1.3 ”定制 端点 





定制 端点 一 般 通 过 endpoints+ 端 点 名 + 属性 名 来 设置 ， 


之 间 用 . 隔 开 。 
(1) 修改 端点 id 


endpoints.beans.id=mybeans 


此 时 我 们 访问 的 端点 地 址 就 变 成 了 : http://localhost: 


8080/mybeans. 
(2) 开局 端点 
例如 我 们 开局 shutdown 端 点 : 


zm 


E 


endpoints. shutdown. enabled=true 


(3) 关闭 端点 


关闭 beans 端 点 : 


endpoints.beans.enabled=false 


(4) 只 开局 所 需 端点 


只 开 司 所 需 端点 的 话 ， 我 们 可 以 通过 关闭 所 有 的 冰点 ， 
"oil A ria fig ARSE, Un. 








endpoints.enabled=false 
endpoints.beans.enabled=true 


(5) 定制 端点 访问 路 径 


默认 的 端点 访问 路 径 是 在 根 目 录 下 的 ， 如 http:/localhost: 
8080/beans。 我 们 可 以 通过 下 面 配置 修改 : 








management .context-path=/manage 


此 时 我 们 的 访问 地 址 就 变 成 了 : http://localhost: 
8080/manage/beans 


(6) 定制 端 扩 访问 站 口 





ARIETES, AGES i A oi LT SUPR ADEST, Gb 
n e JW. FAS Ep BI M 5 ig REUS n Pr FB Bo HAE H AP E HE 2 H e 
RATE VEE RU P CS OLR Y AV I] HP H : 





management.port-8081 


(7) 关闭 http 端 点 
管理 http 端 点 可 使 用 下 面 配置 实现 : 





management.port=-1 


11.1.4” 自 定义 端点 


当 Spring Boot 提 供 的 端点 不 能 满足 我 们 特殊 的 逢 求 而 我 
们 叉 需 要 对 特殊 的 应 用 状态 进行 监控 的 时 候 ， 束 需要 自 定 义 一 
个 端点 。 

本 例 演 示 当 应 用 改变 了 一 个 变量 的 状态 时 ， 我 们 可 以 通过 
端点 监控 变量 的 状态 。 

我 们 只 需 继承 一 个 AbstractEndpoint 的 实现 类 ， 并 将 其 注册 
为 Bean 即 可 。 


1. 状 态 服务 








package com.wisely.chi1 1; 


import org.springframework.stereotype.Service; 


@Service 
public class StatusService { 


private String status; 


public String getStatus() { 
return status; 


} 


public void setStatus(String status) { 
this.status = status; 


} 


代码 解释 
此 类 无 任何 特别 ， 仅 为 改变 status 的 值 。 


2. H XE XI Ei 


package com.wisely.chi1 1; 


import 
import 
import 
import 
import 


org. 
org. 
org. 
org. 
org. 


springframework. 


springframework 
springframework 
springframework 
springframework 


beans.BeansException; 


.boot.actuate.endpoint.AbstractEndp 
.boot.context.properties.Configurat 
.context.ApplicationContext; 
.context.ApplicationContextAware; 


@ConfigurationProperties(prefix = "endpoints.status", ignoreU 
public class StatusEndPoint extends AbstractEndpoint<String> 


ApplicationContext context; 


public StatusEndPoint() ( 
super("status"); 


QOverride 


public String invoke() { //3 
StatusService statusService = context.getBean(StatusS 


j 


return 


QOverride 
public void setApplicationContext(ApplicationContext argO 
this.context - arg0; 


代码 解释 
n 的 设置 ， 我 们 可 


application.properties 中 通 


"The Current Status is :"+statusService.getSt 


过 endpoints.status 配 置 我 们 的 端点 。 


人 @O 继 承 AbstractEndpoint 类 ，AbstractEndpoint 是 Endpoint 接 


口 的 抽象 实现 ， 当 前 类 


一 定 要 重 写 invoke 方 法 。 实 现 


ApplicationContextAware 接 口 可 以 让 当前 类 对 Spring 容器 的 资 
源 有 意识 ， 即 可 访问 容器 的 六 


(8) 通过 重 写 invoke 方 法 ，i 
3. 注 册 问 点 并 定义 演示 控制 器 


package com.wisely.chi1 1; 


import 
import 
import 
import 
import 
import 
import 


org. 
org. 
org. 
org. 
org. 
org. 
org. 


springframework. 
springframework. 
springframework. 
springframework. 
.context.annotation.Bean; 

.web.bind.annotation.RequestMapping 


springframework 
springframework 


springframework. 


资源 。 
返回 我 们 要 监控 的 内 容 。 


beans.factory.annotation.Autowired 
boot.SpringApplication; 
boot.actuate.endpoint.Endpoint; 
boot.autoconfigure.SpringBootAppli 


web.bind.annotation.RestController 


@SpringBootApplication 
@RestController 
public class DemoApplication { 
@Autowired 
StatusService statusService; 


public static void main(String[] args) { 
SpringApplication.run(DemoApplication.class, args); 


@Bean //1 
public Endpoint<String> status() { 
Endpoint<String> status = new StatusEndPoint(); 


return status; 


} 

@RequestMapping("/change") //2 

public String changeStatus(String status){ 
statusService.setStatus(status); 

return "OK"; 


} 


代码 解释 
注册 端点 的 Bean。 
GO 定义 控制 器 方法 用 来 改变 status。 


4. 运 行 





启动 程序 ， 访 问 http://localhost: 8080/status， 此 时 效果 如 
图 11-13 所 示 。 


@ localhost:8080/status x 


e Q f [3E ECHTE: 





The Current Status is :null 





[11-13 访问 status 


当 我 们 通过 控制 器 访问 http://localhost: 8080/change? 
status=running， 改 变 status 的 值 的 时 候 ， 如 图 11-14 所 示 。 





OK 





图 11-14 改变 status 的 值 


我 们 在 通过 访问 http://localhost: 8080/status 查 看 status 的 状 
态 时 ， 结 果 如 图 11-15 所 示 。 


@ localhost:8080/stat x \ @ localhost:8080/ch: x 


€ Q fi |B localhost:8080/status 





The Current Status is :running 





图 11-15 ”查看 status 的 状态 


11.1.5 HŒ X HealthIndicator 


Health 信 息 都 是 从 ApplicationContext 中 所 有 的 
HealthIndicator 的 Bean 中 收集 的 ，Spring 中 内 置 了 一 些 
HealthIndicator， 如 表 11-2 所 示 。 


表 11-2 Spring 中 内 置 的 HealthIndicator 


名 称 描 述 
DiskSpacheHealthIndicator 检测 低 磁 盘 空 间 















DataSourceHealthIndicator 检测 DataSource 连接 是 否 能 获得 





ElasticsearchHealthIndicator 检测 ElasticSear 





JmsHealthIndicator 检测 IMS 7 





los ni 


MailHealthIndicator 检测 邮件 





MongoHealthIndicator 检测 MongoDB 是 否 





RabbitHealthIndicator 检测 RabbitMQ 是 否 在 运行 


名 th ti x 


RedisHealthIndicator 检测 Redis 是 否 在 运行 











SolrHealthIndicator 检测 Redis 是 否 在 运行 


在 本 节 我 们 讲述 了 如 何 定制 自 己 的 HealthIndicator， 定 制 自 
己 的 HealthIndicator 我 们 只 需 定 一 个 实现 HealthIndicator 接 口 的 
类 ， 并 注册 为 Bean 即 可 。 接 着 上 面 的 例子 ， 我 们 依然 通过 上 例 
的 status 值 决定 健康 情况 ， 只 有 当 status 的 值 为 ranning 时 才 为 健 
康 。 





1.HealthIndicator 实 现 类 


package com.wisely.chi1 1; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.boot.actuate.health.Health; 
import org.springframework.boot.actuate.health.HealthIndicato 
import org.springframework.stereotype.Component; 
@Component 
public class StatusHealth implements HealthIndicator {//1 
@Autowired 
StatusService statusService; 


QOverride 
public Health health() { 
String status = statusService.getStatus(); 
if(status == null||!status.equals("running")) 


{ 


return Health.down().withDetail("Error", "Not Running").build 


} 
return Health.up().build(); //3 


代码 解释 

(实现 HealthIndicator 接 口 并 重 写 health() 方法 。 
地 当 status 的 值 为 非 running 时 构造 失败 。 

3) 其 余 情况 运行 成 功 。 

2351] 


运行 程序 ， 访 问 http://localhost: 8080/health， 如 图 11-16 所 


@ localhost8080/health x 


c C fi |D localhost:8080/health 





{ V Parsed 
"status": “DOWN”, 


"statusHealth": { 
"status": “DOWN”, 
"Error': “Not Running" 





"diskSpace": | 
"status": "UP", 
“total”: 118958563328. 
"free": 75690139648, 
"threshold" 10485760 
}, 
“links” [ 
{ 
“rel”: “self”, 
“href”: “http: // localhost: 8080/health" 





图 11-16 访问 health 


这 时 我 们 修改 status 的 值 为 ranning， 访 问 http:/localhost: 
8080/change? status=running， 如 图 11-17 所 示 。 


g localhost8080/healh x / g@ localhost:8080/change? x 
€ C fi | 5localhost:8080/change?status-running 


OK 








图 11-17 访问 running 


再 次 访问 http:/localhost: 8080/health， 显 示 如 图 11-18 所 
ZN o 


j @ localhost:8080/health x w localhost:8080/change? x 
€ > Q fi D localhost:8080/health 
{ | Raw 




















i 
"diskSpace": { 
“status”: "UP", 
“total”: 118958563328, 
"free": 75686649856, 
“threshold”: 10485760 





i. 
“links”: [ 
{ 
rel": “self”, 
“href”: “http: //localhost: 8080/health" 
} 
] 








11-18 ”再 次 访问 heath 


11.2 JMX 





我 们 也 可 以 通过 JMX 对 应 用 进行 监控 和 管理 。 本 节 应 用 上 
一 节 的 例子 演示 。 


在 控制 台 调 用 Java 内 置 的 jconsole 来 实现 JMX 监 控 ， 如 图 
11-19 所 示 。 


RK 10.0. 10240] 


orporation. All rights reserved. 





图 11-19 调用 jconsole 


这 时 会 打开 jconsole 页 面 ， 选 择 当 前 程序 的 进程 ， 如 图 11- 
20 上 所 示 。 


国 Java MIO = 0 x] 
连接 (C) BOW) RH) 





e 新 建 连接 


© 本 地 进程 (L) - 


Owen oo: 


Wii. (ortname) (ort ÉD service: imr roto 
Ré): 














图 11-20 jconsole Ji [fij 


进入 界面 后 ， 在 MBean 标 签 的 org.springframework.boot 域 
下 可 对 我 们 的 程序 进行 监控 和 管理 ， 如 图 11-21 所 示 。 





























11-21 MBean 标 签 


11.3 SSH 


我 们 还 可 以 通过 SSH 或 TELNET 监 控 和 管理 我 们 的 应 用 ， 
这 一 点 Spring Boot 是 借助 CraSH Chttp://www.crashub.org) 来 实 
现 的 。 在 应 用 中 ， 我 们 只 需 在 Spring ”Boot 项 目 中 添加 spring- 
boot-starter-remote-shellfK $ B] PJ 。 


11.3.4 新 建 Spring Boot 项 目 


新 建 Spring Boot 项目， 依赖 为 Remote Shell (spring-boot- 
starter-remote-shell) 。 


项 目 信 息 : 


groupId: com.wisely 
arctifactId:chi11 3 
package: com.wisely. chii1 3 


113.2 íT 


局 动 程 序 ， 此 时 控制 台 会 所 示 SSH 访 问 的 密码 ， 如 图 11-22 
所 示 。 


me we NAL 

E a OES ee: Ree OES 

me hae Pa Pe GUI 39») 

I- 3 23] bt} PR Pe 

=========|_ |==============| /=/ / / / 

:: Spring Boot :: (v1.3.0.M4) 
2015-08-24 15:17:04.626 INFO 3924 --- [ main] com.wisely.ch12 3.Ch123Appl 
2015-08-24 15:17:04.783 INFO 3924 --- [ main] s.c.a.AnnotationConfigAppli 
2015-08-24 15:17:05.502 INFO 3924 --- [ main] roperties$SimpleAuthenticat 
sing default password for shell access: 1fb7a6d6-2bb5-4851-88bd-23f298011687 
2015-08-24 15:17:06.432 INFO 3924 --- [ main] o.s.j.e.a.AnnotationMBeanEx 
2015-08-24 15:17:06.436 INFO 3924 --- [ main] o.s.c.support.DefaultLifecy 
2015-08-24 15:17:06.494 INFO 3924 --- [ main] com.wisely.ch12 3.Ch123Appl 


图 11-22 SSH 访 问 的 密码 


这 样 束 可 以 通过 下 面 信息 登录 我 们 的 程序 (SSH 客 户 端 可 
使 用 puTTY、SecureCRT 等 ) ， 登 录 界 面 如 图 11-23 所 示 。 








主机 :localhost 
端口 :2000 
帐号 :User 


密码 : 上 面 截图 


Quick Connect 


Protocol: ‘ssH2 vi 


Hostname : localhost 
Port: Firewall: | None v | 
iere 


Authentication 
[7]Password ^ Properties... 
[7]PublicKey 
[7]Keyboard Interactive x 
[7]GSSAPI 








L] Show quick connect on startup [7] Save session 
[_] Open in a tab 


[ connect | | cance! 





图 11-23 SRA 
登录 后 的 效果 如 图 11-24 所 示 。 


localhost (1) - SecureCRT 
File Edit View Options Transfer Script Tools Window Help 

25d S Col, Zod oa Enter host <Alt+R> aA 659 7x17 e 
| localhost (1) x nmm xp i 












v 


Ready ssh2: AES-128-CTR 8, 3 24 Rows, 80 Cols VT100 CAP NUM 


图 11-24 ”登录 后 的 效果 


11.3.3 ”常用 命令 


(1) help 


localhost - SecureCRT 
File Edit View Options Transfer Script Tools Window Help 


253.583 [5,6 8}, Enter host <Alt+R> Ba £s dà. ETE) USE [7] E 


EST TT DUST 1 22:35 
271.3] RCE a ie 


LJ 
:; Spring Boot :: (v1.3.0.M4) on wisely-PC 


» help 
Try one of these commands with the -h or --help switch: 


NAME DESCRIPTION 
autoconfig Display auto configuration report from Applicationcontext 
beans Display beans in Ben) ea ten 
manages the cron plugin 
a monitoring dashboard 
search filets) for lines that match a pattern 
Invoke actuator endpoints 
display the term env 
a filter for a stream of map 
various java language commands 
Java Management Extensions 
java.util. logging commands 
JM informations 
opposite of more 
interact with emails 
format and display the on-line manual pages 
Display metrics provided by Spring Boot 
shell related command 
sleep for some time 
sort a map 
system vm system properties commands 
thread JW thread commands 
help provides basic help v 








Ready ssh2: AES-128-CTR 31, 3 31Rows,78 Cols VT100 CAP NUM 


图 11-25 ”命令 列表 





(2) metrics 


输入 metrics 命 令 ， 效 果 如 网 11-26 所 示 。 


| ff localhost (1) - SecureCRT 
Ele Edit View Options Iransfer Script Tools Window Help 
1.353 83.2.23. AX. Enter host <Alt+R> 25 0h r Se Se R) 
© localhost (1) x | 


VALUE 


processors | 
instance. uptime 
uptime 


. unloaded 
gc. pS_scavenge. count 
gc. ps_scavenge. time 


K .ps-marksweep. count 
v 





ssh2: AES-128-CTR 24, 1 24 Rows, 80 Cols CAP NUM 





图 11-26 输入 metrics 命 令 


(3) endpoint 
输入 下 面 命令 获得 端点 列表 ， 如 图 11-27 所 示 。 


endpoint list 


localhost (1) - SecureCRT 
File Edit View Options Transfer Script Tools Window Help 
35) iJ (a) G9) 383, Enter host <Alt+R> A 6345 F323 t © 


+ localhost (1) x 





> endpoint list 


envi ronmentEndpoi nt 
healthEndpoint 


beansEndpoint 
infoEndpoint 


metricsEndpoint 
traceEndpoint 


RE 


autocCol 


igurationReportEndpoint 


configurationPropertiesReportEndpoint 


> 


Ready 


ssh2: AES-128-CTR 12, 3 12 Rows, 92 Cols  VT100 


图 11-27 端点 列表 





调用 某 一 个 端点 ， 如 调用 health， 如 图 11-28 所 示 。 


endpoint invoke health 


localhost (1) - SecureCRT 
File Edit View Options Transfer Script Tools Window Help 
359) Sid [11 29) 28. Enter host <Alt+F Ad l3 age © 


© localhost (1) x 





> endpoint invoke health 
{status=UP, diskSpace={status=UP, total-118958563328, free-76133871616, threshold=10485760}} 


> 





Ready 





ssh2: AES-128-CTR 5, 3 5 Rows, 92 Cols VT100 CAP NUM 


11-28 调用 health 


11.3.4 定制 登录 用 户 


我 们 可 以 通 


过 在 application.properties 下 定制 下 面 的 属性 ， 


实现 用 户 的 账号 密码 的 定制 : 


shell.auth.simple.user.name-wyf 
shell.auth.simple.user.password-wyf 


11.3.5 扩展 命令 


可 以 在 spring-boot-starter-remote-shell.jar 中 看 到 Spring Boot 
为 我 们 定制 的 命令 ， 如 图 11-29 所 示 。 





v ba spring-boot-starter-remote-shell-1.3.0.M4,jar 


v {4 commands.crash 


autoconfig.groovy 


beans.groovy 


mp 


endpoint.groovy 


=) login.groovy 
metrics.groovy 


My [Hilt 


mp 


E META-INF 








[11-29 Spring Boot 定 制 的 命令 


如 beans.groovy 的 代码 为 : 


package commands 
import org.springframework.boot.actuate.endpoint.BeansEndpoin 
class beans ( 

QUsage("Display beans in ApplicationContext") 


@Command 
def main(InvocationContext context) { 


def result = [:] 
context.attributes['spring.beanfactory'].getBeansOfTy 


result.put(name, endpoint.invoke()) 


} 
result.size() == 1 ? result.values()[0] : result 








需要 于 守 别 指出 内 是 ， 这 里 使 用 了 Groovy 请 言 来 编制 命令 ， 
Groovy 语 言 古 由 Spring 主 导 的 运行 于 VM 的 动态 语言 ， 是 可 以 
替代 Java 作 为 开发 语言 的 。 在 这 里 还 需 说 明 的 是 ，Spring Boot 
既 可 以 用 Java 语 言 开 发 ， 也 可 以 用 Groovy 语 言 开 有 发， 本 书 为 了 
减少 学 习 曲 线 ， c m 所 以 没有 对 
Groovy 语 言及 Groovy 开 发 Spring 进行 介绍 ， 读 者 如 有 兴趣 可 自 
ÍT 2] Groovy 


另 一 个 值得 注意 的 是 mnvocationContext， 我 们 可 以 通过 
InvocationContext 获 得 表 11-3 所 示 的 属性 。 


表 11-3 属性 


属性 名 Ho 述 
Spring Boot 的 版 本 

Spring 框架 的 版 本 

WIH] Spring 的 BeanFactory 





























spring.enviroment 访问 Spring 的 Enviroment 


这 里 将 以 Groovy 语 言 演 示 一 个 命令 的 定制 ， 命 令 可 放 在 以 
FEX, Spring Boot 会 自动 扫描 : 





classpath*:/commands/** 
classpath*:/crash/commands/** 


在 src/main/resources 下 新 建 commands 文 件 夹 ， 新 建 


hello.groovy， 内 容 如 下 : 


package commands 
import org.crsh.cli.Command 
import org.crsh.cli.Usage 
import org.crsh.command. InvocationContext 
class hello { 
QUsage("Say Hello")//1 
@Command//2 
def main(InvocationContext context) { 


def bootVersion = context.attributes[ 'spring.boot.ver 
def springVersion = context.attributes[ 'spring.versio 


return "Hello, your Spring Boot version is "+bootVersi 


代码 解释 
使 用 @Usage 注 解 解释 该 命令 的 用 途 。 
@) 使 用 @Command 注 解 当前 是 一 个 CRaSH 命 令 。 


(3) 获 得 Spring Boot 的 版 本 ， 注 意 Groovy 的 方法 和 变量 声明 
关键 字 为 def。 


(获得 Spring 框 架 的 版 本 。 
(返回 命令 执行 结 
an 


此 时 我 们 运行 程序 ， 并 以 SSH 客 户 端 登录 ， 输 入 hello 命 
令 ， 可 获得 如 图 11-32 所 示 结 果 。 





localhost - SecureCRT = 口 x 
File Edit View Options Transfer Script Tools Window Help 
Joux Enter host <Alt+R> Ga aA la 5s mot e E 




















dE eS ae 

i zoring Boot :: (v1.3.0.M4) on wisely-PC 

> he 

heg your Spring Boot version is 1.3.0.M4,your Spring Framework version is 4.2.0.RELEASE 
> 


v 





Ready ssh2: AES-128-CTR 10, 3 13 Rows, 91 Cols  VT100 CAP NUM 





图 11-32 ”运行 程序 


HQ TATRA A 


12.1 微服 务 、 原 生 云 应 用 


微服 务 〈Microservice ) 是 近 两 年 来 非常 火 的 概念 ， 它 的 含 
Xe: 使 用 定义 好 边界 的 小 的 独立 组 件 来 做 好 一 件 事 情 。 微 服 
务 是 相对 于 传统 单 块 式 架构 而 言 的 。 


单 块 式 染 构 是 一 份 代码 ， 部 车 和 伸缩 都 是 基于 单个 单元 进 
行 的 。 它 的 优点 是 易于 部 蜀 ， 但 是 面临 着 可 用 性 低 、 可 伸缩 性 
差 、 集 中 发 布 的 生命 周期 以 及 违反 单一 功能 原则 (Single 
Responsibility Principle) 。 微 服务 的 出 现 解决 了 这 个 问题 ， 它 
以 单个 独立 的 服务 来 做 一 个 功能 ， 且 要 做 好 这 个 功能 。 但 使 用 
微服 务 不 可 避免 地 将 功能 按照 边界 拆 分 为 单个 服务 ， 体 现 出 分 
布 式 的 特征 ， 这 时 每 个 微服 务 之 间 的 通信 将 是 我 们 要 解决 的 问 


jel. 


Spring Cloud 的 出 现 为 我 们 解决 分 布 式 开发 利用 到 的 问题 给 
出 了 完整 的 解决 方案 。Spring Cloud 基 于 Spring Boot， 为 我 们 
提供 了 配置 管理 、 服 务 发 现 、 断 路 器 、 代 理 服 务 等 我 们 在 做 分 
布 式 开发 时 常用 问题 的 解决 方案 。 


基于 Spring Cloud 开 发 的 程序 特别 适合 在 Docker 或 者 其 他 专 
业 PaaS 〈 平 台 即 服务 ， 如 Cloud Foundry) 部 署 ， 所 以 又 称 作 原 
生 云 应 用 (Cloud Native Application) 。 

















12.2 Spring Cloud P3 ATI 


12.2.1 配置 服务 





Spring Cloud 提 供 了 Config Server， 它 有 在 分 布 式 系统 开发 
中 外 部 配置 的 功能 。 通 过 Config Server， 我 们 可 以 集中 存储 所 
有 应 用 的 配置 文件 。 


Config Server 文 持 在 git 或 者 在 文件 系统 中 放置 配置 文件 。 
可 以 使 用 以 下 格式 来 区 分 不 同 应 用 的 不 同 配置 文件 : 














/{application}/{profile}[/{label} | 
/{application}-{profile}.yml 
/{label}/{application}-{profile}.yml 
/{application}-{profile}.properties 
/{label}/{application}-{profile}.properties 


Spring Cloud 提供 了 注解 @EnableConfigServer 来 启用 配置 


服务 。 


12.2.2 ”服务 发 现 





Spring Cloud 通 过 Netflix OSS 的 Eureka 来 实现 服务 发 现 ， 服 
务必 现 的 主要 目的 是 为 了 让 每 个 服务 之 间 可 以 互相 通信 。 
Eureka Server 为 微服 务 注 册 中 心 。 


Spring Cloud 使 用 注解 的 方式 提供 了 Eureka 服 务 端 








(@EnableEurekaServer) #7 ð (@EnableEurekaClient) 。 


12.2.3 ”路 由 网 关 











路 由 网 关 的 主要 目的 是 为 了 让 所 有 的 微服 务 对 外 只 有 一 个 
接口 ， 我 们 只 需 访 问 一 个 网 关 地 址 ， 即 可 由 网 关 将 我 们 的 请 求 
代理 到 不 同 的 服务 中 。 


Spring Cloud 是 通过 Zuul 来 实现 的 ， 支 持 上 自动 路 由 映射 到 在 
Eureka Server 上 注册 的 服务 。Spring Cloud 提 供 了 注解 
@EnableZuulProxy 来 启用 路 由 代理 。 





12.2.4 ”负载 均衡 


Spring Cloud 提供 了 Ribbon 和 Feign 作 为 客户 端的 负载 均 
衡 。 在 Spring Cloud 下 ， 使 用 Ribbon 直 接 注 入 一 个 RestTemplate 
对 象 即 可 ， 此 RestTemplate 已 做 好 负载 均衡 的 配置 ， 而 使 用 
Feign 只 需 定义 个 注解 ， 有 @FeignClient 注 解 的 接口 ， 然 后 使 用 
@RequestMapping 注 解 在 方法 上 映射 远程 的 REST 服 务 ， 此 方 
法 也 是 做 好 负载 均衡 配置 的 。 





12.2.5 上 断路 器 


ERAS (Circuit Breaker) ， 主 要 是 为 了 解决 当 某 个 方法 调 
用 失败 的 时 候 ， 调 用 后 备 方法 来 蔡 代 失败 的 方法 ， 以 达到 和 雁 
错 、 阻 止 级 联 错误 等 功能 。 


Spring Cloud 使 用 @EnableCircuitBreaker 来 启用 断路 器 文 


持 ， 使 用 @HystrixCommand 的 fallbackMethod 来 指定 后 备 方 
es 


Spring Cloud 还 给 我 们 提供 了 一 个 控制 台 来 监控 断路 器 的 运 
行情 况 。 通 过 @EnableHystrixDashboard 注 解 开 启 。 





12.3 ”实战 


实战 部 分 主要 由 6 个 微服 务 组 成 : 


config: 配置 服务 器 ， 本 例 为 person-service 和 some-service 
提供 外 部 配置 。 


discovery: Eureka Server 为 微服 务 提供 注册 。 
person: 为 UI 模块 提供 保存 person 的 REST 服 务 。 
some: 为 UI 模块 返回 一 段 字符 串 。 


UI: 作为 应 用 网 天 ， 提 供 外 部 访问 的 唯一 入 口 。 使 用 Feign 
消费 person 服 务 、Ribbon 消 费 some 服 务 ， 且 都 提供 断路 器 功 


能 ; 
monitor: 监控 UI 模块 中 的 断路 器 。 
本 例 没 有 完全 列 出 代码 ， 读 者 可 自行 翻阅 源码 ch12。 























12.3.1 项 目 构 建 


新 建 模块 化 的 maven 项 目 ch12， 其 pom.xml 文 件 的 主要 部 分 
如 下 


(1) 使 用 <modules> 标 签 来 实现 模块 化 : 


<modules> 


<module>config</module> 

<module>discovery</module> 

<module>ui</module> 

<module>person</module> 

<module>some</module> 

<module>monitor</module> 
</modules> 


(2) {#9 spring-cloud-starter-parent*# {Xspring-boot-starter- 
parent， 其 具备 spring-boot-starter-parent 的 同样 功能 并 附加 了 
Spring Cloud 的 依赖 ， 当 前 最 新 稳定 版 为 Angel.SR3: 








<parent> 
«groupId»org.springframework.cloud«/groupId» 
<artifactId>spring-cloud-starter- 
parent«/artifactId» 
«version» Angel.SR3</version> 
«relativePath/» 
«/parent» 


(3) 在 此 pom.xml 文 件 里 添加 的 dependency 对 所 有 的 子 模 
块 都 是 有 效 的 ， 即 在 子 模块 不 用 再 额外 添加 这 些 依 赖 : 





<dependencies> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter- 
web</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
actuator</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter- 
test</artifactId> 


<scope>test</scope> 
</dependency> 
</dependencies> 


12.3.2 ”服务 发 现 Discovery (Eureka Server ) 





1. fA RR 


服务 及 现 依赖 于 Eureka Server， 所 以 本 模块 加 上 如 下 依赖 
B uf: 


«dependencies» 

«dependency» 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-starter</artifactiId> 

</dependency> 

<dependency> 
«groupId»org.springframework.cloud«c/groupId» 

<artifactId>spring-cloud-starter -eureka- 
server</artifactId> 

</dependency> 

</dependencies> 


2. 关 键 代 码 


package com.wisely.discovery; 


import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootAppli 
import org.springframework.cloud.netflix.eureka.server.Enable 


@SpringBootApplication 
@EnableEurekaServer 
public class DiscoveryApplication { 


public static void main(String[] args) { 
SpringApplication.run(DiscoveryApplication.class, 





} 

代码 解释 

一 个 常规 的 Spring Boot 项 目 ， 我 们 只 需要 使 用 
@EnableEurekaServer 注 解 开 启 对 EurekaServer 的 支持 即 可 。 

3.40. 





在 云 计 算 环 境 下 ， 习 惯 上 使 用 YAML 配 置 ， 此 处 我 们 也 和 采 
用 YAML 配 置 。 


application.yml: 
server: 
port: 8761 #1 
eureka: 
instance: 
hostname: localhost #2 
client: 


register-with-eureka: false #3 
fetch-registry: false 


代码 解释 

(当前 Eureka Server 服 务 的 端口 号 为 8761。 
当前 Eureka Server 的 hostname 为 localhost。 
@) 当 前 服务 不 需要 到 Eureka Server 上 注册 。 


12.3.3 WE 





Config (Config Server ) 


1. 依 赖 


Spring Cloud 为 我 们 提供 了 作为 配置 服务 的 依赖 spring- 
cloud-config-server， 以 及 作为 eureka 客 户 端的 依赖 spring-cloud- 
starter-eureka: 


<dependencies> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-starter</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-config- 
server</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter - 
eureka</artifactId> 
</dependency> 
</dependencies> 


2. 关 键 代 码 


package com.wisely.config; 


import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootAppli 
import org.springframework.cloud.config.server.EnableConfigSe 
import org.springframework.cloud.netflix.eureka.EnableEurekaC 


QSpringBootApplication 
QEnableConfigServer //1 
QEnableEurekaClient //2 

public class ConfigApplication { 


public static void main(String[] args) { 
SpringApplication.run(ConfigApplication.class, ar 


代码 解释 
(Df FA (QEnableConfigServer7T Ja AC EU 25 as WY SC E e 


Dit Hl o EnableEurekaClient7T JHifF7jEureka Server 的 客户 
Nm] SC FF o 


3. 配 置 





bootstrap.yml 


spring: 
application: 
name: config #1 
profiles: 
active: native #2 


eureka: 
instance: 
non-secure-port: ${server.port:8888} #3 
metadata-map: 
instanceld: ${spring.application.name}:${random. value} 
client: 
service-url: 
defaultzone: http://${eureka.host:localhost}:${eureka.p 


代码 解释 


这 里 对 bootstrap.yml 做 一 下 解释 ，Spring Cloud 应 用 提供 使 
FAbootstrap.yml (bootstrap.properties) 负责 从 外 部 资源 加 载 配 


置 属性 。 
(D 在 Erueka Server 注 册 的 服务 名 为 config。 
人 配置 服务 器 使 用 本 地 配置 〈 默 认为 git 配 置 ) 。 


@@ 非 SSL 端 口 ， 若 环境 变量 中 server.port 有 值 ， 则 使 用 环境 
变量 的 值 ， 没 有 则 使 用 8080。 


(DO E Æ Eureka Server 的 实例 ID。 
©Eureka% F vig 1x & Eureka Server 的 地 址 。 
application.yml 


spring: 
cloud: 
config: 
server: 
native: 
search-locations: classpath:/config #1 


server: 
port: 8888 


代码 解释 


配置 其 他 应 用 所 需 的 配置 文件 的 位 置 位 于 类 路 径 下 的 
config 目 录 下 ， 如 图 12-1 所 示 。 





w © src/main/resources 
v (m "ong 
person-docker.yml 
j| person.yml 


2 j sonas-dociengmi 





= some.yml 


图 12-1 config A xe 
配置 文件 的 规则 为 : 应 用 名 +profile.yml。 





12.3.4 ”服务 模块 一 Person 服务 


1. 依 赖 


本 模块 需要 做 数据 库 操作 ， 故 添加 spring-boot-starter-data- 
jpa 依 赖 〈 在 开发 环境 下 使 用 hsqldb， 在 Docker 生 产 环 境 下 使 用 
PostgreSQL) ; 本 模块 还 需要 使 用 Config Server 的 配置 ， 故 添 
加 Spring-cloud-config-client 依 赖 。 








<dependencies> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-starter</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-config- 
client</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-starter - 


eureka</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-data- 
jpa</artifactId> 
</dependency> 
<dependency> 
«groupId»org.hsqldb«/groupId-» 
<artifactId>hsqldb</artifactId> 
</dependency> 
<dependency> 
«groupId»postgresql«/groupId-» 
<artifactId>postgresql</artifactId> 
<version>9.1-901-1.jdbc4</version> 
</dependency> 
</dependencies> 


2. 关 键 代 码 


本 模块 没有 特别 值得 关注 的 代码 ， 主 要 是 实现 数据 库 的 一 
个 保存 操作 ， 并 将 保存 操作 其 露 给 UI 模 块 调用 。 





package com.wisely.person.controller; 


import java.util.List; 


import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.data.domain.PageRequest; 

import org.springframework.web.bind.annotation.RequestBody; 
import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.RestController 


import com.wisely.person.dao.PersonRepository; 
import com.wisely.person.domain.Person; 


@RestController 

public class PersonController { 
@Autowired 
PersonRepository personRepository; 


@RequestMapping(value = "/save", method = RequestMethod.P 

public List<Person> savePerson(@RequestBody String perso 

Person p = new Person(personName) ; 

personRepository.save(p); 

List<Person> people = personRepository.findAll(new PageRe 
return people; 

} 


3. 配 置 


bootstrap.yml: 


spring: 
application: 
name: person 
cloud: 
config: 
enabled: true 
discovery: 
enabled: true 
service-id: CONFIG Z1 
eureka: 
instance: 
non-secure-port: ${server.port:8082} 
client: 
service-url: 


defaultzone: http://${eureka.host:localhost}:${eureka.p 


代码 解释 


指定 Config Server 的 服务 名 ， 将 会 通过 Eureka Server 友 现 
Config Server. 


在 开发 环境 下 使 用 hsqldb: (Config Server 下 的 


person.yml) : 


spring: 
jpa: 
database: HSQL 





在 Docker 生 产 环 境 下 使 用 PostgreSQL (Config Server FJ 
person-docker.yml) : 


spring: 

jpa: 
database: POSTGRESQL 

datasource: 
platform: postgres 
url: jdbc:postgresql://postgres:5432/postgres 
username: postgres 
password: postgres 
driver-class-name: org.postgresql.Driver 


application.yml: 


server: 
port: 8082 
spring: 
jpa: 
hibernate: 


ddl-auto: update 


12.3.5 ”服务 模块 一 -Some 服务 





1. 依 赖 


<dependencies> 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId» 


client</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId-» 


eureka</artifactId> 
</dependency> 
</dependencies> 


2. 关 键 代 码 


package com.wisely.some; 


import 
import 
import 
import 
import 
import 


org. 
org. 


org 


org. 
org. 
org. 


springframework. 
springframework. 
.Springframework. 
springframework. 
.web.bind.annotation.RequestMapping 


springframework 


springframework. 


QSpringBootApplication 

QEnableDiscoveryClient 

QRestController 

public class SomeApplication { 
@Value("S${my.message}") //1 
private String message; 


QRequestMapping(value 
public String getsome(){ 
return message; 


<artifactId>spring-cloud-config- 


<artifactId>spring-cloud-starter - 


beans.factory.annotation.Value; 
boot .SpringApplication; 

boot .autoconfigure.SpringBootAppli 
cloud.client.discovery.EnableDisco 


web.bind.annotation.RestController 


= "/getsome" ) 


public static void main(String[] args) { 
SpringApplication.run(SomeApplication.class, args); 


此 处 通过 @Value 注 入 的 值 来 自 于 Config Server. 
在 开发 环境 下 (Config Server 下 的 some.yml) 。 


my: 
message: Message from Development 


在 Docker 生 产 环境 下 (Config Server 下 的 Some- 
docker.yml) : 


my: 
message: Message from Production 


3. 配 置 


bootstrap.yml: 


spring: 
application: 
name: some 
cloud: 
config: 
enabled: true 
discovery: 
enabled: true 
service-id: CONFIG 
eureka: 
instance: 
non-secure-port: ${server.port:8083} 
client: 
service-url: 
defaultzone: http://${eureka.host:localhost}:${eureka.p 


application.yml: 


server: 
port: 8083 


12.3.6 ”界面 模块 一 UI (Ribbon, Feign) 


1. 依 赖 


本 模块 会 使 用 ribbon、feign、zuul 以 及 CircuitBreaker， 所 以 
需 添加 相关 依赖 。 本 模块 是 一 个 具有 界面 的 模块 ， 所 以 通过 
webjar 加 载 了 一 些 和 常用 的 脚本 框架 : 


<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter - 
hystrix«/artifactId» 
«/dependency» 
«dependency» 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-starter - 
zuul</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-config- 
client</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloudc/groupId» 
<artifactId>spring-cloud-starter - 
eureka</artifactId> 


</dependency> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-starter- 
feign</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId-» 
<artifactId>spring-cloud-starter - 
ribbon</artifactId> 
</dependency> 
<dependency> 
«groupId»org.webjars«/groupId» 
<artifactId>bootstrap</artifactId> 
</dependency> 
<dependency> 
«groupId»org.webjars«/groupId» 
<artifactId>angularjs</artifactId> 
<version>1.3.15</version> 
</dependency> 
<dependency> 
«groupId»org.webjars«/groupId» 
<artifactId>angular -ui-router</artifactId> 
<version>0.2.13</version> 
</dependency> 
<dependency> 
«groupId»org.webjars«/groupId» 
<artifactId>jquery</artifactId> 
</dependency> 
</dependencies> 


2. 关 键 代码 
CINA: 


package com.wisely.ui; 


import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootAppli 
import org.springframework.cloud.client.circuitbreaker.Enable 
import org.springframework.cloud.netflix.eureka.EnableEurekaC 
import org.springframework.cloud.netflix.feign.EnableFeignCli 
import org.springframework.cloud.netflix.zuul.EnablezuulProxy 


@SpringBootApplication 
@EnableEurekaClient 
@EnableFeignClients //1 
@EnableCircuitBreaker //2 
@EnableZuulProxy //3 
public class UiApplication { 
public static void main(String[] args) { 
SpringApplication.run(UiApplication.class, args); 


代码 解释 
通过 @EnableFeignClients 开 启 feign 客 户 端 支持 。 
G@) 通 过 @EnableCircuitBreaker 开 局 CircuitBreaker 的 文 持 。 
@ 通 过 @EnableZuulProxy 开 局 网 关 代 理 的 文 持 
(2) 使 用 feign 调 用 Person Service: 


package com.wisely.ui.service; 
import java.util.List; 


import org.springframework.cloud.netflix.feign.FeignClient; 
import org.springframework.http.MediaType; 

import org.springframework.web.bind.annotation.RequestBody; 
import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.ResponseBody; 


import com.wisely.ui.domain.Person; 


QFeignClient("person") 
public interface PersonService ( 
QRequestMapping(method - RequestMethod.POST, value - "/s 
produces - MediaType.APPLICATION JSON VALUE, 
@ResponseBody List<Person> save(@RequestBody String 


代码 解释 


我 们 只 需 通过 简单 的 在 接口 中 声明 方法 即 可 调用 Person 服 
务 的 REST 服 务 。 


(3) 调用 Person Service 的 断路 器 : 





package com.wisely.ui.service; 


import 
import 


import 
import 
import 
import 


java.util.ArrayList; 
java.util.List; 


org.springframework.beans.factory.annotation.Autowired 
org.springframework.stereotype.Service; 
com.netflix.hystrix.contrib.javanica.annotation.Hystri 
com.wisely.ui.domain.Person; 


@Service 


public 


class PersonHystrixService { 


@Autowired 
PersonService personService; 


@HystrixCommand(fallbackMethod = "fallbackSave") //1 
public List<Person> save(String name) { 


j 


return personService.save(name); 


public List<Person> fallbackSave(){ 


List<Person> list = new ArrayList<>(); 
Person p = new Person("Person Service 故障 " ) ; 
list.add(p); 

return list; 


代码 解释 


(使 用 @HystrixCommand 的 fallbackMethod 参 数 指定 ， 当 
本 方法 调用 失败 时 ， 调 用 后 备 方法 fallbackSave。 


(4) 使 用 ribbon 调 用 Some Sevice, 34 HI TER Z3: 


package com.wisely.ui.service; 

import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.stereotype.Service; 

import org.springframework.web.client.RestTemplate; 


import com.netflix.hystrix.contrib.javanica.annotation.Hystri 


@Service 
public class SomeHystrixService { 


@Autowired 
RestTemplate restTemplate; //1 


@HystrixCommand(fallbackMethod = "fallbackSome") //2 
public String getSome() { 

return restTemplate.getForObject("http://some/getsome 
} 


public String fallbackSome(){ 
return "some service 模 块 故障 "， 
} 


代码 解释 


在 Spring Boot 下 使 用 Ribbon， 我 们 只 需 注 入 一 个 
RestTemplate 即 可 ，Spring Boot 已 为 我 们 做 好 了 配置 。 


使 用 @HystrixCommand 的 fallbackMethod 参 数 指定 ， 当 本 
方法 调用 失败 时 调用 后 备 方法 fallbackSome。 


3. 配 置 


bootstrap.yml: 


spring: 
application: 
name: ui 


eureka: 
instance: 
non-secure-port: ${server.port:80} 
client: 
service-url: 
defaultzone: http://${eureka.host:localhost}:${eureka.p 


application.yml 
server: 
port: 80 


12.3.7 ”上 断路 器 监控 一 -Monitor (DashBoard) 


1. 依 赖 


<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter</artifactId> 
</dependency> 
<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
<artifactId>spring-cloud-starter-hystrix- 
dashboard</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter - 
turbine</artifactId> 
</dependency> 
</dependencies> 


2. 主 要 代码 


package com.wisely.monitor; 


import org.springframework. 
import org.springframework. 
import org.springframework. 
import org.springframework. 
import org.springframework. 


@SpringBootApplication 
@EnableEurekaClient 
@EnableHystrixDashboard 
@EnableTurbine 


boot .SpringApplication; 

boot .autoconfigure.SpringBootAppli 
cloud.netflix.eureka.EnableEurekaC 
cloud.netflix.hystrix.dashboard.En 
cloud.netflix.turbine.EnableTurbin 


public class MonitorApplication ( 


public static void main(String[] args) { 
SpringApplication.run(MonitorApplication.class, args) 


3. 配 置 


bootstrap.yml 


spring: 
application: 
name: monitor 


eureka: 
instance: 


nonSecurePort: ${server.port:8989} 


client: 
serviceUrl: 


defaultzone: http://${eureka.host:localhost}:${eureka.p 


application.yml 


server: 
port: 8989 


se 7 


12.3.8 运行 


我 们 依次 局 动 DiscoveryApplication、ConfigApplication， Ja 
面 所 有 的 微服 务 局 动 不 分 顺序 ， 最 后 启动 MonitorApplication 。 
此 时 访问 http://localhost: 8761, #4Eureka Server， 如 图 12-2 
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图 12-2 ”查看 Eureka Server 


1. 访 问 UI 服 务 

UI 服务 既是 我 们 的 页 面 ， 也 是 我 们 的 网 天 代理 。 在 实际 生 
产 环 境 中 ， 服 务 器 防火 墙 只 需 将 此 端口 暴露 给 外 网 即 可 ， 访 问 
http://localhost， 如 图 12-3 所 示 。 
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图 12-3 访问 localhost 


(1) 调用 Person Service， 如 图 12-4 所 示 。 
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通过 Person Service 保 存 person 
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图 12-4 调用 person-service 


(2) 调用 Some service， 如 图 12-5 所 示 。 
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图 12-5 ”调用 some-service 
2. WT ER as 


此 时 停止 Pearson ServicefllSome Service， 观 察 断 路 器 的 效 
果 ， 分 别 如 图 12-6 和 图 12-7 所 示 。 
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图 12-6 停止 Person Service 
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图 12-7 停止 Some Service 
3. AT ER as n d 


访问 http://localhost: 8989/hystrix.stream， 如 图 12-8 所 示 。 
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图 12-8 访问 hystrix.stream 


输入 http:/localhosthystrix.stream， 如 图 12-9 所 示 。 
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图 12-9 447 A. http://localhost/hystrix.stream 


监控 界面 如 图 12-10 所 示 。 
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Hystrix Stream: http://localhost/hystrix.stream HYSTRIX 
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Host 0.0/s 
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12.4 基于 Docker 部 署 


以 Spring Cloud 开 发 的 微服 务 程序 十 分 适合 在 Docker 环 境 下 


ADAE o 
12.4.1 Dockerfile#n 5j 

以 上 6 个 微服 务 的 Dockerfile 的 编写 几乎 完全 一 致 ， 此 处 只 
以 config 模 块 为 例 。 

1.runboot.sh 脚 本 编写 

位 于 src/main/docker 下 : 


java -Djava.security.egd-file:/dev/./urandom 
jar /app/app.jar 


根据 启动 顺序 ， 调 整 sleep 的 时 间 。 
2.Dockerfile 编 写 


位 于 src/main/docker 下 : 


FROM java:8 

VOLUME /tmp 

RUN mkdir /app 

ADD config-1.0.0-SNAPSHOT.jar /app/app. jar 
ADD runboot.sh /app/ 


RUN bash -c ‘touch /app/app.jar' 
WORKDIR /app 

RUN chmod a+x runboot.sh 

EXPOSE 8888 

CMD /app/runboot.sh 


为 不 同 的 微服 务 我 们 只 需 修改 ; 


ADD config-1.0.0-SNAPSHOT.jar /app/app.jar 


以 及 端口 


EXPOSE 8888 


3.Docker 的 maven 插 件 
在 开发 机 器 编译 Docker 镜 像 到 服务 器 ， 使 用 docker-maven- 





plugin 即 可 ， 在 所 有 程序 的 pom.xml 内 增加 : 


<build> 
<plugins> 
<plugin> 
«groupId»com.spotify«c/groupId» 
<artifactId>docker -maven- 
plugin</artifactId> 
<configuration> 
<imageName>${project.name}:${project.vers 
</imageName> 
<dockerDirectory>${project.basedir}/src/m 
<skipDockerBuild>false</skipDockerBuild> 
<resources> 
<resource> 
<directory>${project.build.direct 
</directory> 


<include>${project.build.finalNam 
</resource> 
</resources> 
</configuration> 
</plugin> 
</plugins> 
«/build» 


4. 编 译 镜像 


使 用 docker-maven-plugin， 默 认 将 Docker 编 译 到 localhost。 
如 果 是 远程 Linux 服 务 器 ， 请 在 环境 变量 中 配置 
DOCKER_HOST， 本 例 的 Linux 服 务 器 的 地 址 是 192.168.1.68， 
如 图 12-11 所 示 。 














[12-11 Linux 服务器 的 地 址 
在 控制 台 下 进入 ch12 目 录 ， 执 行 下 面 语 句 : 


mvn clean package docker:build -DskipTests 





编译 完成 后 效果 如 图 12-12 所 示 。 








图 12-12 ”编译 后 效果 
查看 Linux 服 务 器 上 的 镜像 ， 如 网 12-13 所 示 。 





图 12-13 ” Linux 服务 器 上 的 镜像 


12.4.2 Docker Compose 





Docker Compose 是 用 来 定义 和 运行 多 容器 应 用 的 工具 。 关 
于 DockerCompose 的 安装 和 使 用 请 查看 


https://docs.docker.com/compose/。 


Docker Compose 使 / 用 | 一 个 docker-compose.yml 来 描述 多 容器 
的 定义 ， 使 用 下 面 命令 运行 整个 应 用 。 


docker-compose up 


12.4.3 Docker-compose.yml4 5 


postgresdb: 
image: busybox 
volumes: 
- /var/lib/postgresql/data 


postgres: 
name: postgres 
image: postgres 
hostname: postgres 
volumes_from: 


- postgresdb 
# ports: 
# - "5432:5432" 
environment: 


- POSTGRES_USER=postgres 
- POSTGRES_PASSWORD=postgres 


discovery: 
image: "discovery:1.0.0-SNAPSHOT" 
hostname: discovery 
name: discovery 
ports: 
- "8761:8761" 


config: 

image: "config:1.0.0-SNAPSHOT" 

hostname: config 

name: config 

links: 
- discovery 

environment: 
EUREKA_HOST: discovery 
EUREKA_PORT: 8761 


# ports: 
# - "8888:8888" 
person: 


image: person:1.0.0-SNAPSHOT 
hostname: person 
links: 

- discovery 

- config 


- postgres 
environment: 
EUREKA_HOST: discovery 
EUREKA_PORT: 8761 
SPRING PROFILES ACTIVE: docker 
# ports: 
# - "8082:8082" 


some: 
image: some:1.0.0-SNAPSHOT 
hostname: some 
links: 
- discovery 
- config 
environment: 
EUREKA_HOST: discovery 
EUREKA_PORT: 8761 
SPRING PROFILES ACTIVE: docker 
# ports: 
# - "8083:8083" 


ui: 
image: ui:1.0.0-SNAPSHOT 
hostname: ui 
links: 
- discovery 
- config 
- person 
- some 
environment: 
EUREKA HOST: discovery 
EUREKA PORT: 8761 
SPRING PROFILES ACTIVE: docker 
ports: 
- "80:80" 


monitor: 
image: monitor:1.0.0-SNAPSHOT 
hostname: monitor 
links: 
- discovery 
- config 
- person 
- some 
- ui 
environment: 
EUREKA HOST: discovery 
EUREKA PORT: 8761 


SPRING_PROFILES ACTIVE: docker 





# ports: 

# - "8989:8989" 

代码 解释 

enviroment: 给 容器 使 用 的 变量 ， 在 容器 中 使 用 ${} 来 调 
FA. 





links: 当前 容器 依赖 的 容器 ， 可 直接 使 用 依赖 容器 的 已 
有 端口 。 


(Sports: RIE BU RE OR AN i BEAR BY Tm 
口 则 不 做 映射 。 





AA, 3517 


将 docker- compose.yml 上 传 全 Linux 服 务 器 上 ， 在 文件 当前 
目录 执行 下 面 命令 : 


docker-compose up -d 





-d 表 示 后 台 运 行 。 
启动 运行 效果 如 图 12-14 所 示 。 


ker-compose up -d 


kse. 


2 monitor 1... 





图 12-14 ”启动 运行 效果 


这 时 我 们 可 以 在 本 地 访问 http://192.168.1.68: 8761 和 
http://192.168.1.68， 分 别 如 图 12-15 和 图 12-16 所 示 。 
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CONFIG nad) (1) UP (1) - config:config:ea6c5c97fe4d9be98d16398c32aeb00e 
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PERSON n/a) (1) UP (1) - pers 

SOME n/ad) (1) UP (1) - some 

ul n/a(1) (1) UP (1) - ui 





General Info 


Value 


865mb 








图 12-15 访问 效果 (http://192.168.1.68: 8761) 
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图 12-16 ”访问 效果 Chttp://192.168.1.68 ) 


附录 A 


AJ 基于 JHipster 的 代码 生成 


JHipster 是 一 个 代码 生成 占 ， 可 以 用 来 生成 基于 Spring Boot 
和 AngularJS 的 项 目 。 


1. 安 装 Node.JS 

下 载 地 址 : https://nodejs.org/download/ 

2. 安 装 Git 客 户 端 

下 载 地 址 : https://git-scm.com/download/win 


3. 安 装 Yeoman generator 


npm install -g yo 


4,248 JHipster 


npm install -g generator-jhipster 


5. 22258 Bower 


npm install -g bower 


6.22 Grunt 


npm install -g grunt-cli 


7. 使 用 JHipster 生 成 项 目 


mkdir hello-boot 
cd hello-boot 
yo jhipster 





执行 下 面 代码 ， 效 果 如 图 A-1 所 示 。 





图 A-1 执行 效果 





按照 提示 问 导 进行 操作 ， 如 图 A-2 所 示 。 





图 A-2 ”按照 提示 问 导 操作 
最 终 完 成 的 结 末 如 图 A-3 所 示 。 





图 A-3 完成 
生成 的 代码 文件 结构 如 图 A-4 所 示 。 





电脑 > 本 地 磁盘 (C) » BP > wisely > hello-boot 





=| pom | 
_ | README.md 2015/8/27 15:36 MD 文件 


图 A-4 文件 结构 




















在 程序 目录 下 ， 执 行 下 面 代码 : 


mvn spring-boot:run 


访问 http://localhost: 8080， 效 果 如 图 A-5 所 示 。 





Welcome, Java Hipster! 


This is your homepage 


G) 


1 you want to authenticate, you can try the defaut accounts 
Imnistrator (ogm= ME ana passwora-"aamir 
iogini-"usei* and passsord-"use 











图 A-5 访问 http://localhost: 8080 


以 账号 和 密码 都 为 admin 登 录 系 统 ，JHipster 已 为 我 们 做 了 
很 多 基础 的 工作 ， 如 图 A-6 所 示 。 
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Memory Threads (Total 24) © 
Total Memory (250M / 1.879M) Runnable 6 


a x 
Heap Memory (140M / 1.879) Timed Waiting (5) 
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Non-Heap Memory (109M / 111M) Waiting (11) 


HTTP requests (events per second) 
Active requests 1 - Total requests 136 


Average (1 min) Average (5 min) Average (15 min) 


图 A-6 ”登录 系统 
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# COMMON SPRING BOOT PROPERTIES 

# 

# This sample file is provided as a guideline. Do NOT copy it 
# entirety to your own application. AAA 


# BANNER 
banner .charset=UTF-8 # banner file encoding 
banner .location=classpath:banner.txt # banner file location 


# SPRING CONFIG (ConfigFileApplicationListener 


) 
spring.config.name- # config file name (default to 'applicati 
spring.config.location- # location of config file 


# PROFILES 
spring.profiles.active- # comma list of active profiles 


spring.profiles.include- # unconditionally activate the speci 


4 APPLICATION SETTINGS (SpringApplication 


) 


spring.main.sources- # sources (class name, package name or X 
spring.main.web-environment- # detect by default 
spring.main.show-banner-true 

spring.main....- # see class for all properties 


# ADMIN (SpringApplicationAdminJmxAutoConfiguration 


) 


spring.application.admin.enabled-false # enable admin feature 
spring.application.admin. jmx- 
name-org.springframework.boot:type-Admin,name-SpringApplicati 


# OUTPUT 
spring.output.ansi.enabled-detect # Configure the ANSI output 


# LOGGING 

logging.path-/var/logs 

logging.file=myapp.log 

logging.config= # location of config file (default classpath: 
logging.level.*= # levels for loggers, e.g. "logging.level.or 


# IDENTITY (ContextiIdApplicationContextinitializer 


) 
spring.application.name- 
spring.application.index- 


# EMBEDDED SERVER CONFIGURATION (ServerProperties 


) 
server .port=8080 
server.address= # bind to a specific NIC 


server.session-timeout= # session timeout in seconds 
server .context- 
parameters.*= # Servlet context init parameters, e.g. server. 
parameters.a=alpha 
server.context-path= # the context path, defaults to '/' 
server.jsp-servlet.class- 
name=org.apache.jasper.servlet.JspServlet # The class name of 
server.jsp-servlet.init- 
parameters.*= # Init parameters used to configure the JSP ser 
server .jsp- 
servlet.registered=true # Whether or not the JSP servlet is r 
server.servlet-path- # the servlet path, defaults to '/' 
server .display-name= # the display name of the application 
server.ssl.enabled-true # if SSL support is enabled 
server.ssl.client-auth- # want or need 
server.ssl.key-alias- 
server.ssl.ciphers- # supported SSL ciphers 
server.ssl.key-password= 
server.ssl.key-store- 
server.ssl.key-store-password- 
server.ssl.key-store-provider- 
server.ssl.key-store-type- 
server.ssl.protocol-TLS 
server.ssl.trust-store- 
server.ssl.trust-store-password- 
server.ssl.trust-store-provider- 
server.ssl.trust-store-type- 
server.tomcat.access-log- 
pattern- £ log pattern of the access log 
server.tomcat.access-1log- 
enabled-false # is access logging enabled 
server.tomcat.compression-off # is compression enabled (off, 
server.tomcat.compressable-mime- 
types-text/html, text/xml, text/plain # comma - 
separated list of mime types that Tomcat will compress 
server .tomcat.internal- 
proxies=10\\.\\d{1, 3}\\.\\d{1, 3}\\.\\d £1, 3} | \\ 
192\\.168\\.\\d{1, 3) NN. NNd(1,3)] NN 
169NN.254NN. NNd (1, 3}\\.\\d{1, 3} | \\ 
127\\.\\d{1, 3) NN. NNd(1,3)2NN.NNd(1,3) |NN 
172\\.1[6-9] (13 NN. NNd(1, 3) NN. NNd(1,33|NN 
172NN.2[0-9] (13 NN. NNd(1, 3) NN. NNd(1,33|NN 
172\\.3[0-1] 
{A}\\.\\d{1, 3}\\.\\d{1,3} # regular expression matching trust 
server .tomcat.protocol-header=x -forwarded- 
proto # front end proxy forward header 
server.tomcat.port-header= # front end proxy port header 
server .tomcat.remote-ip-header=x-forwarded- for 


server.tomcat.basedir=/tmp # base dir (usually not needed, de 
server.tomcat.background-processor-delay-30; # in seconds 
server .tomcat.max-http-header - 

size= # maximum size in bytes of the HTTP message header 
server.tomcat.max- 

threads = 0 # number of threads in protocol handler 
server.tomcat.uri-encoding - UTF- 
8 # character encoding to use for URL decoding 
server.undertow.access-1log- 

enabled-false # if access logging is enabled 
server.undertow.access-1log- 

pattern=common # log pattern of the access log 
server.undertow.access-log-dir-logs # access logs directory 
server.undertow.buffer-size- # size of each buffer in bytes 
server.undertow.buffers-per- 

region- # number of buffer per region 
server.undertow.direct- 

buffers-false # allocate buffers outside the Java heap 
server.undertow.io- 

threads- £ number of I/O threads to create for the worker 
server.undertow.worker-threads- # number of worker threads 


# SPRING MVC (WebMvcProperties 


) 


spring.mvc.locale- £ set fixed locale, e.g. en UK 
spring.mvc.date- 

format- £ set fixed date format, e.g. dd/MM/yyyy 
spring.mvc.favicon.enabled-true 
spring.mvc.message-codes-resolver- 

format= # PREFIX ERROR CODE / POSTFIX ERROR CODE 
spring.mvc.ignore-default-model-on- 

redirect-true # If the the content of the "default" model sho 
spring.view.prefix- # MVC view prefix 

spring.view.suffix- # ... and suffix 


4 SPRING RESOURCES HANDLING (ResourceProperties 


) 


spring.resources.cache- 


period= # cache timeouts in headers sent to browser 
spring.resources.add- 
mappings-true # if default mappings should be added 


# MULTIPART (MultipartProperties 


multipart.enabled-true 

multipart.file-size- 

threshold=0 # Threshold after which files will be written to 
multipart.location- # Intermediate location of uploaded files 
multipart.max-file-size=1Mb # Max file size. 
multipart.max-request-size-10Mb # Max request size. 


# SPRING HATEOAS (HateoasProperties 


spring.hateoas.apply-to-primary-object- 
mapper-true # if the primary mapper should also be configured 


# HTTP encoding (HttpEncodingProperties 


) 
spring.http.encoding.charset=UTF- 


8 # the encoding of HTTP requests/responses 
spring.http.encoding.enabled-true # enable http encoding supp 
spring.http.encoding.force-true £ force the configured encodi 


# HTTP message conversion 
spring.http.converters.preferred-json- 
mapper- # the preferred JSON mapper to use for HTTP message c 


# HTTP response compression (GzipFilterProperties 


) 

spring.http.gzip.buffer- 

size- # size of the output buffer in bytes 
spring.http.gzip.deflate-compression- 

level- # the level used for deflate compression (0-9) 
spring.http.gzip.deflate-no- 

wrap- # noWrap setting for deflate compression (true or false 
spring.http.gzip.enabled-true # enable gzip filter support 


spring.http.gzip.excluded-agents- # comma - 
separated list of user agents to exclude from compression 
spring.http.gzip.exclude-agent-patterns- # comma - 
separated list of regular expression patterns to control user 
spring.http.gzip.exclude-paths- # comma - 
separated list of paths to exclude from compression 
spring.http.gzip.exclude-path-patterns= # comma - 
separated list of regular expression patterns to control the 
spring.http.gzip.methods- # comma - 
separated list of HTTP methods for which compression is enabl 
spring.http.gzip.mime-types= # comma- 
separated list of MIME types which should be compressed 
spring.http.gzip.excluded-mime-types= # comma- 


separated list of MIME types to exclude from compression 
spring.http.gzip.min-gzip- 

size= # minimum content length required for compression to oc 
spring.http.gzip.vary= # Vary header to be sent on responses 


# JACKSON (JacksonProperties 


) 
spring.jackson.date-format= # Date format string (e.g. yyyy- 
MM-dd HH:mm:ss), or a fully- 


qualified date format class name (e.g. com.fasterxml.jackson. 
spring.jackson.property-naming- 

strategy= # One of the constants on Jackson's PropertyNamingS 
qualified class name of a PropertyNamingStrategy subclass 
spring. jackson.deserialization.*= # see Jackson's Deserializa 
spring. jackson.generator.*= # see Jackson's JsonGenerator.Fea 
spring. jackson. joda-date-time- 

format= # Joda date time format string 

spring. jackson.mapper.*= # see Jackson's MapperFeature 
spring. jackson.parser.*= # see Jackson's JsonParser.Feature 
spring.jackson.serialization.*= # see Jackson's Serialization 


spring. jackson.serialization- 
inclusion= # Controls the inclusion of properties during seri 


# THYMELEAF (ThymeleafAutoConfiguration 


spring.thymeleaf.check-template-location-true 
spring.thymeleaf.prefix-classpath:/templates/ 


spring.thymeleaf.excluded-view-names- # comma - 
separated list of view names that should be excluded from res 
spring.thymeleaf.view-names- # comma - 


separated list of view names that can be resolved 
spring.thymeleaf.suffix-.html 

spring.thymeleaf .mode=HTML5 

spring.thymeleaf.enabled=true # enable MVC view resolution 
spring.thymeleaf .encoding=UTF -8 
spring.thymeleaf.content-type-text/html # ;charset- 
«encoding» is added 

spring.thymeleaf.cache-true # set to false for hot refresh 


# FREEMARKER (FreeMarkerAutoConfiguration 


) 


spring.freemarker.allow-request-override-false 
spring.freemarker.cache-true 
spring.freemarker.check-template-location-true 
spring.freemarker.charset-UTF-8 
spring.freemarker.content-type-text/html 
spring.freemarker.enabled-true # enable MVC view resolution 
spring.freemarker.expose-request-attributes-false 
spring.freemarker.expose-session-attributes-false 
spring.freemarker.expose-spring-macro-helpers-false 
spring.freemarker.prefix- 
spring.freemarker.request-context-attribute- 
spring.freemarker.settings.*- 
spring.freemarker.suffix-.ftl 
spring.freemarker.template-loader- 
path=classpath:/templates/ # comma-separated list 
spring. freemarker.view- 

names= # whitelist of view names that can be resolved 


# GROOVY TEMPLATES (GroovyTemplateAutoConfiguration 


) 
spring.groovy. 
spring.groovy. 
spring.groovy. 
location=true 

spring.groovy. 
spring.groovy. 
spring.groovy. 
spring.groovy. 
spring.groovy. 
spring.groovy. 
names- 


# 


template. 
template. 
template 
template 
template 
template. 
# whitelist of view names that can be resolved 


template.cache=true 
template.charset-UTF-8 
template.check-template- 


check that the templates location exists 
configuration.*- # See GroovyMarkupCon 
content-type-text/html 

.enabled-true # enable MVC view resolut 
.prefix-classpath:/templates/ 
.suffix-.tpl 

view- 


# VELOCITY TEMPLATES (VelocityAutoConfiguration 


) 

spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 


allow-request-override-false 
cache-true 
check-template-location-true 
charset=UTF-8 
content-type=text/html 
date-tool-attribute= 

enabled=true # enable MVC view resolution 
expose-request-attributes=false 
expose-session-attributes=false 
expose-spring-macro-helpers=false 
number -tool-attribute= 
prefer-file-system- 


access=true # prefer file system access for template loading 


spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 
spring.velocity. 


prefix= 

properties. *= 

request-context-attribute= 

resource-loader -path=classpath:/templates/ 
suf fix=.vm 

toolbox -config- 


location= # velocity Toolbox config location, for example "/W 


INF/toolbox. xml" 


spring.velocity.view- 
names= # whitelist of view names that can be resolved 


# MUSTACHE TEMPLATES (MustacheAutoConfiguration 


) 


spring.mustache.cache=true 

spring.mustache.charset=UTF-8 
spring.mustache.check-template-location=true 
spring.mustache.content-type-UTF-8 
spring.mustache.enabled-true # enable MVC view resolution 
spring.mustache.prefix- 

spring.mustache.suffix-.html 

spring.mustache.view- 

names- # whitelist of view names that can be resolved 


# JERSEY (JerseyProperties 


) 


spring.jersey.type-servlet £ servlet or filter 
spring.jersey.init- # init params 
spring.jersey.filter.order- 


# INTERNATIONALIZATION (MessageSourceAutoConfiguration 


) 


spring.messages.basename-messages 
spring.messages.cache-seconds--1 
spring.messages.encoding-UTF-8 


# SECURITY (SecurityProperties 


) 


security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 
security. 


user.name=user # login username 

user.password= # login password 

user.role=USER # role assigned to the user 
require-ssl=false # advanced settings 
enable-csrf=false 

basic.enabled=true 

basic.realm=Spring 

basic.path= # /** 

basic.authorize-mode= # ROLE, AUTHENTICATED, NONE 
filter-order=0 

headers.xss=false 

headers.cache=false 

headers.frame=false 

headers.content-type=false 

headers.hsts=all # none / domain / all 
sessions=stateless # always / never / if_required / 
ignored= # Comma- 


separated list of paths to exclude from the default secured p 


# OAuth2 


client (OAuth2ClientProperties 


spring.oauth2.client.client-id= # OAuth2 client id 
spring.oauth2.client.client- 
secret- # OAuth2 client secret. A random secret is generated 


# OAuth2 


SSO (OAuth2SsoProperties 


spring.oauth2.sso.filter- 


order- # 


Filter order to apply if not providing an explicit W 


spring.oauth2.sso.login- 


path= # Path to the login page, i.e. 


the one that triggers th 


# DATASOURCE (DataSourceAutoConfiguration 


& DataSourceProperties 


spring. 
spring. 
spring. 
spring. 
spring. 


datasource. 
datasource. 
datasource. 
datasource. 
datasource. 


name= # name of the data source 
initialize=true # populate using data.sql 
schema= # a schema (DDL) script resource re 
data= # a data (DML) script resource refere 
sql-script- 


encoding= # a charset for reading SQL scripts 
spring.datasource.platform- # the platform to use in the sche 
${platform}.sql) 
spring.datasource.continue-on- 

error-false # continue even if can't be initialized 


spring. 
spring. 
spring. 
spring. 
spring. 
spring. 


datasource. 
datasource. 
datasource. 
datasource. 
datasource. 
datasource. 


separator-; # statement separator in SQL in 
driver-class-name- # JDBC Settings... 

url- 

username- 

password- 

jndi- 


name- # For JNDI lookup (class, url, username & password are 
spring.datasource.max- 
active-100 # Advanced configuration... 


spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 


datasource. 
datasource. 
datasource. 
datasource. 
datasource. 
datasource. 
datasource. 
datasource. 
datasource. 
datasource. 
datasource. 


max-idle-8 

min-idle-8 

initial-size-10 
validation-query- 
test-on-borrow-false 
test-on-return-false 
test-while-idle- 
time-between-eviction-runs-millis- 
min-evictable-idle-time-millis- 
max-wait- 

jnx- 


enabled-false # Export JMX MBeans (if supported) 


# DAO (PersistenceExceptionTranslationAutoConfiguration 


spring.dao.exceptiontranslation.enabled-true 


# MONGODB (MongoProperties 


) 
spring.data.mongodb.host- # the db host 


spring.data.mongodb.port=27017 # the connection port (default 
spring.data.mongodb.uri=mongodb://localhost/test # connection 
spring.data.mongodb.database= 
spring.data.mongodb.authentication-database- 
spring.data.mongodb.grid-fs-database- 
spring.data.mongodb.username- 

spring.data.mongodb.password- 
spring.data.mongodb.repositories.enabled-true # if spring dat 


# JPA (JpaBaseConfiguration 


, HibernateJpaAutoConfiguration 


) 


spring.jpa.properties.*- # properties to set on the JPA conne 
spring. jpa.open-in-view=true 

spring.jpa.show-sql-true 

spring.jpa.database-platform- 

spring.jpa.database- 

spring.jpa.generate- 

ddl-false £ ignored by Hibernate, might be useful for other v 
spring.jpa.hibernate.naming-strategy- # naming classname 
spring.jpa.hibernate.ddl-auto- # defaults to create- 
drop for embedded dbs 
spring.data.jpa.repositories.enabled-true # if spring data re 


# JTA (JtaAutoConfiguration 


) 
spring.jta.log-dir- # transaction log dir 
spring.jta.*- # technology specific configuration 


# ATOMIKOS 
spring.jta.atomikos.connectionfactory.borrow-connection- 
timeout-30 # Timeout, in seconds, for borrowing connections f 
spring.jta.atomikos.connectionfactory.ignore-session- 
transacted- 

flag-true £ Whether or not to ignore the transacted flag when 
spring.jta.atomikos.connectionfactory.local-transaction- 
mode-false # Whether or not local transactions are desired 
spring.jta.atomikos.connectionfactory.maintenance- 
interval-60 # The time, in seconds, between runs of the pool' 
spring.jta.atomikos.connectionfactory.max-idle- 

time-60 # The time, in seconds, after which connections are c 
spring.jta.atomikos.connectionfactory.max- 

lifetime=0 # The time, in seconds, that a connection can be p 
spring.jta.atomikos.connectionfactory.max-pool- 

size=1 # The maximum size of the pool 
spring.jta.atomikos.connectionfactory.min-pool- 

size-1 # The minimum size of the pool 
spring.jta.atomikos.connectionfactory.reap- 

timeout=0 # The reap timeout, in seconds, for borrowed connec 
spring.jta.atomikos.connectionfactory.unique-resource- 
name-jmsConnectionFactory # The unique name used to identify 
spring.jta.atomikos.datasource.borrow-connection- 

timeout-30 # Timeout, in seconds, for borrowing connections f 
spring.jta.atomikos.datasource.default-isolation- 

level- # Default isolation level of connections provided by t 
spring.jta.atomikos.datasource.login- 

timeout- # Timeout, in seconds, for establishing a database c 
spring.jta.atomikos.datasource.maintenance- 

interval-60 # The time, in seconds, between runs of the pool' 
spring.jta.atomikos.datasource.max-idle- 

time-60 # The time, in seconds, after which connections are c 
spring.jta.atomikos.datasource.max- 

lifetime=0 # The time, in seconds, that a connection can be p 
spring.jta.atomikos.datasource.max-pool- 

size-1 # The maximum size of the pool 
spring.jta.atomikos.datasource.min-pool- 

size=1 # The minimum size of the pool 
spring.jta.atomikos.datasource.reap- 

timeout=0 # The reap timeout, in seconds, for borrowed connec 
spring.jta.atomikos.datasource.test- 

query- # SQL query or statement used to validate a connection 


spring. jta.atomikos.datasource.unique-resource- 
name=dataSource # The unique name used to identify the resour 


# BITRONIX 

spring.jta.bitronix.connectionfactory.acquire- 

increment=1 # Number of connections to create when growing th 
spring.jta.bitronix.connectionfactory.acquisition- 

interval=1 # Time, in seconds, to wait before trying to acqui 
spring.jta.bitronix.connectionfactory.acquisition- 

timeout-30 # Timeout, in seconds, for acquiring connections f 
spring.jta.bitronix.connectionfactory.allow-local- 
transactions-true £ Whether or not the transaction manager sh 
XA transactions 
spring.jta.bitronix.connectionfactory.apply-transaction- 
timeout-false # Whether or not the transaction timeout should 
spring.jta.bitronix.connectionfactory.automatic-enlisting- 
enabled-true # Whether or not resources should be enlisted an 
spring.jta.bitronix.connectionfactory.cache-producers- 
consumers-true # Whether or not produces and consumers should 
spring.jta.bitronix.connectionfactory.defer-connection- 
release-true £ Whether or not the provider can run many trans 
spring.jta.bitronix.connectionfactory.ignore-recovery- 
failures-false £ Whether or not recovery failures should be i 
spring.jta.bitronix.connectionfactory.max-idle- 

time-60 # The time, in seconds, after which connections are c 
spring.jta.bitronix.connectionfactory.max-pool- 

size=10 # The maximum size of the pool. 0 denotes no limit 
spring.jta.bitronix.connectionfactory.min-pool- 

size=0 # The minimum size of the pool 
spring.jta.bitronix.connectionfactory.password- # The passwor 
spring.jta.bitronix.connectionfactory.share-transaction- 
connections-false # Whether or not connections in the ACCESS 
spring.jta.bitronix.connectionfactory.test- 

connections-true £ Whether or not connections should be teste 
spring.jta.bitronix.connectionfactory.two-pc-ordering- 
position=1 # The postion that this resource should take durin 
phase commit (always first is Integer.MIN VALUE, always last 
spring.jta.bitronix.connectionfactory.unique- 
name-jmsConnectionFactory # The unique name used to identify 
spring.jta.bitronix.connectionfactory.use-tm- 

join-true Whether or not TMJOIN should be used when starting 
spring.jta.bitronix.connectionfactory.user- # The user to use 
spring.jta.bitronix.datasource.acquire- 

increment=1 # Number of connections to create when growing th 
spring.jta.bitronix.datasource.acquisition- 

interval=1 # Time, in seconds, to wait before trying to acqui 
spring.jta.bitronix.datasource.acquisition- 

timeout-30 # Timeout, in seconds, for acquiring connections f 


spring.jta.bitronix.datasource.allow-local- 

transactions-true £ Whether or not the transaction manager sh 
XA transactions 
spring.jta.bitronix.datasource.apply-transaction- 
timeout-false # Whether or not the transaction timeout should 
spring.jta.bitronix.datasource.automatic-enlisting- 
enabled-true # Whether or not resources should be enlisted an 
spring.jta.bitronix.datasource.cursor- 

holdability- # The default cursor holdability for connections 
spring.jta.bitronix.datasource.defer-connection- 

release-true £ Whether or not the database can run many trans 
spring.jta.bitronix.datasource.enable-jdbc4-connection- 

test # Whether or not Connection.isValid() is called when acq 
spring.jta.bitronix.datasource.ignore-recovery- 
failures-false £ Whether or not recovery failures should be i 
spring.jta.bitronix.datasource.isolation- 

level- # The default isolation level for connections 
spring.jta.bitronix.datasource.local-auto- 

commit # The default auto- 
commit mode for local transactions 
spring.jta.bitronix.datasource.login- 

timeout- # Timeout, in seconds, for establishing a database c 
spring.jta.bitronix.datasource.max-idle- 

time=60 # The time, in seconds, after which connections are c 
spring.jta.bitronix.datasource.max-pool- 

Size-10 # The maximum size of the pool. © denotes no limit 
spring.jta.bitronix.datasource.min-pool- 

size=0 # The minimum size of the pool 
spring.jta.bitronix.datasource.prepared-statement -cache- 
size=0 # The target size of the prepared statement cache. © d 
spring.jta.bitronix.datasource.share-transaction- 
connections-false # Whether or not connections in the ACCESS 
spring.jta.bitronix.datasource.test- 

query # SQL query or statement used to validate a connection 
spring.jta.bitronix.datasource.two-pc-ordering- 

position=1 # The position that this resource should take duri 
phase commit (always first is Integer.MIN VALUE, always last 
spring.jta.bitronix.datasource.unique- 

name-dataSource # The unique name used to identify the resour 
spring.jta.bitronix.datasource.use-tm- 

join-true Whether or not TMJOIN should be used when starting 


& SOLR ( 


SolrProperties 


spring.data.solr.host=http://127.0.0.1:8983/solr 
spring.data.solr.zk-host= 
spring.data.solr.repositories.enabled-true # if spring data r 


# ELASTICSEARCH (ElasticsearchProperties 


) 


spring.data.elasticsearch.cluster- 

name- The cluster name (defaults to elasticsearch) 
spring.data.elasticsearch.cluster- 

nodes- # The address(es) of the server node (comma- 
separated; if not specified starts a client node) 
spring.data.elasticsearch.properties.*- # Additional properti 
spring.data.elasticsearch.repositories.enabled-true # if spri 


# DATA REST (RepositoryRestConfiguration 


) 


spring.data.rest.base- 
path= # base path against which the exporter should calculate 


# FLYWAY (FlywayProperties 


) 
flyway.*- # Any public property available on the auto- 


configured “Flyway” object 

flyway , check - 

location=false # check that migration scripts location exists 
flyway. locations=classpath:db/migration # locations of migrat 


flyway.schemas= # schemas to update 

flyway.init-version= 1 # version to start migration 
flyway.init- 

sqls- # SQL statements to execute to initialize a connection 
flyway.sql-migration-prefix-zV 
flyway.sql-migration-suffix-.sql 

flyway.enabled-true 

flyway.url- # JDBC url if you want Flyway to create its own D 
flyway.user- # JDBC username if you want Flyway to create its 
flyway.password- £ JDBC password if you want Flyway to create 


# LIQUIBASE (LiquibaseProperties 


) 
liquibase.change-log-classpath:/db/changelog/db.changelog- 
master.yaml 

liquibase.check-change-log- 

location-true # check the change log location exists 
liquibase.contexts- # runtime contexts to use 
liquibase.default-schema- £ default database schema to use 
liquibase.drop-first-false 

liquibase.enabled-true 

liquibase.url- £ specific JDBC url (if not set the default da 
liquibase.user- # user name for liquibase.url 
liquibase.password- # password for liquibase.url 


# JMX 

spring.jmx.default-domain- # JMX domain name 
spring.jmx.enabled-true # Expose MBeans from Spring 
spring.jmx.mbean-serverzmBeanServer # MBeanServer bean name 


# RABBIT (RabbitProperties 


) 


spring.rabbitmq.addresses- # connection addresses (e.g. myhos 
spring.rabbitmq.dynamic=true # create an AmqpAdmin bean 
spring.rabbitmq.host- # connection host 

spring.rabbitmq.port- # connection port 
spring.rabbitmq.password- # login password 
spring.rabbitmq.requested- 


heartbeat= # requested heartbeat timeout, in seconds; zero fo 
spring.rabbitmq.ssl.enabled-false # enable SSL support 
spring.rabbitmq.ssl.key- 

store- # path to the key store that holds the SSL certificate 
spring.rabbitmq.ssl.key-store- 

password- £ password used to access the key store 
spring.rabbitmq.ssl.trust- 

store- # trust store that holds SSL certificates 
spring.rabbitmq.ssl.trust-store- 

password- £ password used to access the trust store 
spring.rabbitmq.username- # login user 
spring.rabbitmq.virtual- 

host- # virtual host to use when connecting to the broker 


# REDIS (RedisProperties 


) 


spring.redis.database- £ database name 
spring.redis.host-localhost £ server host 
spring.redis.password- £ server password 
spring.redis.port-6379 # connection port 
spring.redis.pool.max-idle=8 # pool settings 
spring.redis.pool.min-idle-O 
spring.redis.pool.max-active-8 
spring.redis.pool.max-wait--1 
spring.redis.sentinel.master- # name of Redis server 
spring.redis.sentinel.nodes= # comma - 
separated list of host:port pairs 

spring.redis.timeout- # connection timeout in milliseconds 


4 ACTIVEMQ (ActiveMQProperties 


) 


spring.activemq. broker - 

url-tcp://localhost:61616 # connection URL 
spring.activemq.user= 

spring.activemq.password- 

spring.activemq.in- 

memory=true # broker kind to create if no broker- 
url is specified 


spring.activemq.pooled=false 


# HornetQ (HornetQProperties 


) 


spring.hornetq.mode= # connection mode (native, embedded) 
spring.hornetq.host=localhost # hornetQ host (native mode) 
spring.hornetq.port=5445 # hornetQ port (native mode) 
spring.hornetq.embedded.enabled=true # if the embedded server 
jms-server.jar) 

spring.hornetq.embedded. server -id= # auto- 
generated id of the embedded server (integer) 
spring.hornetq.embedded.persistent-false £ message persistenc 
spring.hornetq.embedded.data- 

directory- # location of data content (when persistence is en 


spring.hornetq.embedded.queues- # comma - 
separated queues to create on startup 
spring.hornetq. embedded. topics= # comma - 


separated topics to create on startup 
spring.hornetq.embedded.cluster - 
password= # customer password (randomly generated by default) 


# JMS (JmsProperties 


) 

spring. jms. jndi- 

name= # JNDI location of a JMS ConnectionFactory 
spring. jms.pub-sub- 

domain= # false for queue (default), true for topic 


# Email (MailProperties 


) 


spring.mail.host-smtp.acme.org # mail server host 
spring.mail.port- # mail server port 
spring.mail.username= 


spring.mail.password= 

spring.mail.default-encoding-UTF- 

8 # encoding to use for MimeMessages 
spring.mail.properties.*- # properties to set on the JavaMail 
spring.mail.jndi-name- # JNDI location of a Mail Session 


4 SPRING BATCH (Ba 


tchProperties 


) 
spring.batch.job.names-job1, job2 


spring.batch.job.enabled-true 
spring.batch.initializer.enabled-true 
spring.batch.schema- £ batch schema to load 
spring.batch.table- 

prefix- # table prefix for all the batch meta-data tables 


# SPRING CACHE (CacheProperties 


) 


spring.cache.type- £ generic, ehcache, hazelcast, infinispan, 
spring.cache.cache- 

names- # cache names to create on startup 
spring.cache.ehcache.config- # location of the ehcache config 
spring.cache.hazelcast.config- # location of the hazelcast co 
spring.cache.infinispan.config- £ location of the infinispan 
spring.cache.jcache.config- # location of jcache configuratio 
spring.cache.jcache.provider- # fully qualified name of the C 
spring.cache.guava.spec- £ guava specs 


# AOP 
spring.aop.auto= 
spring.aop.proxy-target-class- 


# FILE ENCODING (FileEncodingApplicationListener 


) 
spring.mandatory-file- 
encoding- £ Expected character encoding the application must 


# SPRING SOCIAL (SocialWebAutoConfiguration 


) 


spring.social.auto-connection- 
views-true # Set to true for default connection views or fals 


# SPRING SOCIAL FACEBOOK (FacebookAutoConfiguration 


) 


spring.social.facebook.app- 

id- £ your application's Facebook App ID 
spring.social.facebook.app- 

secret- # your application's Facebook App Secret 


4 SPRING SOCIAL LINKEDIN (LinkedInAutoConfiguration 


) 


spring.social.linkedin.app- 

id- £ your application's LinkedIn App ID 
spring.social.linkedin.app- 

secret- # your application's LinkedIn App Secret 


# SPRING SOCIAL TWITTER (TwitterAutoConfiguration 


) 


spring.social.twitter.app- 

id- £ your application's Twitter App ID 
spring.social.twitter.app- 

secret- # your application's Twitter App Secret 


# SPRING MOBILE SITE PREFERENCE (SitePreferenceAutoConfigurat 


) 


spring.mobile.sitepreference.enabled-true # enabled by defaul 


# SPRING MOBILE DEVICE VIEWS (DeviceDelegatingViewResolverAut 


) 


spring.mobile.devicedelegatingviewresolver.enabled-true £ dis 
spring.mobile.devicedelegatingviewresolver.enable- 

fallback- # enable support for fallback resolution, default t 
spring.mobile.devicedelegatingviewresolver.normal-prefix- 
spring.mobile.devicedelegatingviewresolver.normal-suffix- 
spring.mobile.devicedelegatingviewresolver.mobile- 
prefix=mobile/ 

spring.mobile.devicedelegatingviewresolver .mobile-suffix= 
spring.mobile.devicedelegatingviewresolver.tablet- 
prefix-tablet/ 
spring.mobile.devicedelegatingviewresolver.tablet-suffix- 


# DEVTOOLS (DevToolsProperties 


) 


spring.devtools.restart.enabled=true # enable automatic resta 
spring.devtools.restart.exclude= # patterns that should be ex 
spring.devtools.restart.poll- 

interval- # amount of time (in milliseconds) to wait between 
spring.devtools.restart.quiet- 

period- # amount of quiet time (in milliseconds) requited wit 
spring.devtools.restart.trigger- 

file- # name of a specific file that when changed will trigge 
spring.devtools.livereload.enabled-true # enable a livereload 
spring.devtools.livereload.port-35729 £ server port. 


# REMOTE DEVTOOLS (RemoteDevToolsProperties 


) 


spring.devtools.remote.context-path=/.~~spring- 

boot!~ # context path used to handle the remote connection 
spring.devtools.remote.debug.enabled=true # enable remote deb 
spring.devtools.remote.debug.local- 

port-8000 # local remote debug server port 
spring.devtools.remote.restart.enabled-true # enable remote r 
spring.devtools.remote.secret- # a shared secret required to 
spring.devtools.remote.secret-header-namezX-AUTH- 

TOKEN £ HTTP header used to transfer the shared secret 


4 MANAGEMENT HTTP SERVER (ManagementServerProperties 


) 


management.port- £ defaults to 'server.port' 
management.address- # bind to a specific NIC 
management.context-path- # default to '/' 
management.add-application-context- 

header- # default to true 


management.security.enabled=true # enable security 
management.security.role=ADMIN # role required to access the 
management.security.sessions=stateless # session creating pol 


# PID FILE (ApplicationPidFileWriter 


spring.pidfile- # Location of the PID file to write 


# ENDPOINTS (AbstractEndpoint 


subclasses) 
endpoints.autoconfig.id=autoconfig 
endpoints.autoconfig.sensitive=true 
endpoints.autoconfig.enabled=true 
endpoints.beans.id=beans 
endpoints.beans.sensitive=true 
endpoints.beans.enabled=true 
endpoints.configprops.id=configprops 
endpoints.configprops.sensitive=true 
endpoints.configprops.enabled=true 
endpoints.configprops.keys-to- 
sanitize-password,secret,key # suffix or regex 
endpoints.dump.id=dump 
endpoints.dump.sensitive=true 
endpoints.dump.enabled=true 
endpoints.enabled=true # enable all endpoints 
endpoints.env.id=env 
endpoints.env.sensitive=true 
endpoints.env.enabled=true 
endpoints.env.keys-to- 
sanitize-password,secret,key # suffix or regex 
endpoints.health.id=health 
endpoints.health.sensitive=true 
endpoints.health.enabled=true 
endpoints.health.mapping.*= # mapping of health statuses to H 
endpoints.health.time-to-live-1000 
endpoints.info.id-info 
endpoints.info.sensitive-false 
endpoints.info.enabled-true 


endpoints.mappings.enabled-true 
endpoints.mappings.id-mappings 
endpoints.mappings.sensitive-true 
endpoints.metrics.id-metrics 
endpoints.metrics.sensitive-true 
endpoints.metrics.enabled-true 
endpoints.shutdown.id-shutdown 
endpoints.shutdown.sensitive-true 
endpoints.shutdown.enabled-false 
endpoints.trace.id-trace 
endpoints.trace.sensitive-true 
endpoints.trace.enabled-true 


4 ENDPOINTS CORS CONFIGURATION (MvcEndpointCorsProperties 


) 


endpoints.cors.allow- 
credentials- # set whether user credentials are support. When 


endpoints.cors.allowed-origins- # comma - 
separated list of origins to allow. * allows all origins. Whe 
endpoints.cors.allowed-methods= # comma - 
separated list of methods to allow. * allows all methods. Whe 
endpoints.cors.allowed-headers= # comma - 
separated list of headers to allow in a request. * allows all 
endpoints.cors.exposed-headers= # comma - 


separated list of headers to include in a response. 
endpoints.cors.max- 

age=1800 # how long, in seconds, the response from a pre- 
flight request can be cached by clients. 


# HEALTH INDICATORS (previously health.*) 

management .health.db.enabled=true 

management .health.elasticsearch.enabled=true 

management .health.elasticsearch.indices= # comma - 
separated index names 

management .health.elasticsearch.response- 

timeout=100 # the time, in milliseconds, to wait for a respon 
management .health.diskspace.enabled=true 

management .health.diskspace.path=. 

management .health.diskspace.threshold=10485760 
management .health. jms.enabled=true 

management .health.mail.enabled=true 

management .health.mongo.enabled=true 

management .health.rabbit.enabled=true 


management .health.redis.enabled=true 
management .health.solr.enabled=true 
management .health.status.order=DOWN, OUT OF SERVICE, UNKNOWN, 


# MVC ONLY ENDPOINTS 

endpoints. jolokia.path=/jolokia 

endpoints. jolokia.sensitive=true 

endpoints. jolokia.enabled=true # when using Jolokia 


# JMX ENDPOINT (EndpointMBeanExportProperties 


) 


endpoints. jmx.enabled=true # enable JMX export of all endpoin 
endpoints.jmx.domain= # the JMX domain, defaults to 'org.spri 
endpoints. jmx.unique-names=false 

endpoints. jmx.static-names= 


# JOLOKIA (JolokiaProperties 


jolokia.config.*= # See Jolokia manual 


# REMOTE SHELL 

shell.auth=simple # jaas, key, simple, spring 
shell.command-refresh-interval=-1 

shell.command-path- 

patterns- £ classpath*:/commands/**, classpath*:/crash/comman 
shell.config-path-patterns- # classpath*:/crash/* 
shell.disabled-commands-jpa*, jdbc*, jndi* # comma - 
separated list of commands to disable 
shell.disabled-plugins=false # don't expose plugins 
shell.ssh.enabled= # ssh settings 

shell.ssh.key-path= 

shell.ssh.port= 

shell.telnet.enabled= # telnet settings 

shell.telnet.port= 

shell.auth.jaas.domain= # authentication settings 
shell.auth. key. path= 

shell.auth.simple.user.name- 
shell.auth.simple.user.password- 


shell.auth.spring.roles= 


# METRICS EXPORT (MetricExportProperties 


) 


spring.metrics.export. 
spring.metrics.export. 


enabled-true # flag to disable all metr 
delay- 


millis-5000 # delay in milliseconds between export ticks 


spring.metrics.export. 


latest-true £ flag to 


spring.metrics.export. 
spring.metrics.export. 
spring.metrics.export. 


send- 

switch off any available optimizations 
includes- £ list of patterns for metric 
excludes- £ list of patterns for metric 
redis.aggregate-key- 


pattern- £ pattern that tells the aggregator what to do with 


spring.metrics.export. 
spring.metrics.export. 
spring.metrics.export. 


redis.prefix-spring.metrics # prefix fo 
redis.key=keys.spring.metrics # key for 
triggers.*= # specific trigger properti 


# SENDGRID (SendGridAutoConfiguration 


) 


spring.sendgrid.username= # SendGrid account username 
spring.sendgrid.password= # SendGrid account password 
spring.sendgrid.proxy.host= # SendGrid proxy host 
spring.sendgrid.proxy.port- # SendGrid proxy port 


# GIT INFO 


spring.git.properties- # resource ref to generated git info p 
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